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让 开发 自动 化 系列 专栏 


来 源 : 让 开发 自动 化 系列 专栏 


作为 开发 人 人员， 我 们 的 工作 就 是 为 最 终 用 户 实现 过 程 自动 化 ; 然而 ， 很 多 开发 人 员 却 忽略 了 
将 自己 的 开发 过 程 自动 化 的 机 会 。 为 此 ， 自 动 化 专家 Paul Duvall 编写 了 让 开发 自动 化 这 个 
系列 文章 ， 专 门 探讨 软件 开发 过 程 自动 化 的 实际 应 用 ， 并 教 您 何 时 以 及 如 何 成 功 地 应 用 自 
zt o 


让 开发 自动 化 : 部 署 自 动 化 模式 ， 第 2 部 分 


更 多 一 键 式 部 署 模式 


Java™w 部 署 常常 很 混乱 ， 容 易 出 现 错误 ， 需 要 许多 手工 操作 ， 这 会 延误 向 用 户 交付 软件 的 时 
间 。 本 文 是 分 两 部 分 的 让 开发 自动 化 系列 文章 的 第 2 部 分 。 在 本 文中 ， 自 动 化 专家 Paul 
Duvall 进一步 补充 用 于 开发 可 靠 、 可 重复 且 一 致 的 部 署 流程 的 一 些 关键 模式 ， 帮 助 读 者 为 
Java 应 用 程序 生成 简便 的 部 署 。 


关于 本 系列 


作为 开发 人 人员， 我 们 致力 于 为 用 户 自动 化 流程 ; 但 许多 开发 人 员 鸣 忽 了 自动 化 我 们 自己 的 开 
发 流程 的 机 会 。 为 此 ， 我 们 编写 了 让 开发 自动 化 系列 文章 ， 专 门 探讨 软件 开发 流程 自动 化 的 
实践 应 用 ， 为 您 介绍 何 时 以 及 如 何 成 功 应 用 自动 化 。 


部 署 是 软件 创建 过 程 中 又 一 个 适合 实现 自动 化 的 方面 。 通 过 自动 化 部 署 ， 可 获得 一 个 可 靠 、 
可 重复 的 流程 ， 其 中 好 处 颇 多 : 更 高 的 准确 性 、 更 快 的 速度 和 更 好 的 控制 。 在 这 个 分 两 部 分 
的 系列 文章 的 第 1 部 分 中 ， 我 描述 了 8 种 部 署 自动 化 模式 。 在 本 期 ， 我 进一步 扩大 讨论 范 
围 ， 阅 述 另外 7 种 同样 有 益 的 部 署 方法 : 


>- 


。 Binary Integrity， 确 保全 部 目标 环境 使 用 相同 的 工件 。 

e Disposable Container ， 使 目标 环境 处 于 已 知 状态 ， 以 减少 部 署 错误 。 

e Remote Deployment， 确 保 部 署 可 以 从 一 个 集中 化 的 机 器 或 集群 与 多 人 台 机 器 交互 。 

e Database Upgrades， 提 供 一 个 集中 管理 的 、 脚 本 化 流程 ， 以 便 将 增 量 更 改 应 用 到 数据 


库 。 
° Deployment Test， 根 据 最 近 的 部 署 ， 使 用 部 署 前 和 部 署 后 检查 ， 确 认 应 用 程序 按 预期 
运行 。 


e Environment Rollback ， 如 果 部 署 失 败 ， 回 滚 应 用 程序 和 数据 库 更 改 。 
e Protected Files， 控 制 对 构建 系统 使 用 的 某 些 文件 的 访问 。 


图 1 解释 了 本 文 阔 述 的 部 署 模式 之 间 的 关系 (未 使 用 阴影 的 那些 模式 在 第 1 部 分 中 介绍 
ài) 


图 1. 部 署 自动 化 模式 
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这 了 7 个 附加 的 部 署 自动 化 模式 以 之 前 8 个 模式 为 基础 ， 它 们 有 助 于 创建 一 键 式 (one-click) 
部 署 。 





一 次 编译 ， 部 署 到 多 个 环境 

名 称 : Binary Integrity 

模式 : 对 于 每 个 标记 过 的 部 署 ， 每 个 目标 环境 中 使 用 相同 的 归档 文件 (WAR X EAR) 。 
反 模 式 : 对 于 同一 标记 ， 为 每 个 目标 环境 单独 进行 编译 。 


就 这 个 话题 与 同事 经 过 多 次 讨论 后 ， 我 最 终 站 在 了 一 次 编译 ， 部 署 到 多 个 目标 环境 一 边 ， 而 
不 是 在 每 个 目标 环境 中 编译 和 打包 。 ， 一 次 Java 开发 产生 的 部 署 工件 是 Web 归档 

(WAR) 或 企业 归档 (EAR) 文件 。 这 个 归档 应 该 注册 到 版 本 控制 储存 库 中 ， 并 一 次 性 贴 上 
标记 一 就 像 在 DEV 环境 中 那样 。 


图 2 解释 了 一 次 编译 ， 部 署 到 多 个 环境 这 一 概念 : 构建 机 器 上 生成 的 同一 个 brewery.war 被 
部 署 到 每 个 目标 环境 : 


图 2. 同一 个 Web 归档 被 部 署 到 不 同 的 目标 环境 
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Ant 提供 一 个 checksum 任务 一 使 用 Message-Digest algorithm 5 (MD5) hash 算法 一 以 确 
保 构建 机 器 上 编译 和 打包 的 文件 就 是 部 署 到 每 个 目标 环境 的 文件 。 


有 人 会 争辩 说 ， 虽 然 工件 可 能 相同 ， 但 每 个 目标 环境 的 部 署 配置 是 不 同 的 。 也 就 是 说 ， 当 使 
用 Single-Command、Scripted Deployment 时 ， 无 论 它 是 否 为 相同 的 归档 ， 很 多 自动 化 流程 
可 以 改变 应 用 程序 的 输出 。 确 实 如 此 ; 但 是 ， 您 还 需要 花 不 必要 的 时 间 解 决 问题 ， 因 为 在 
STAGE 环境 中 使 用 与 QA 环境 不 同 的 JDK 版 本 编译 和 打包 软件 。 并 且 ， 当 DEV 中 使 用 的 来 
自 一 个 集中 式 依赖 管理 储存 库 (例如 Ivy 或 Maven) 的 JAR 与 准备 (staging) 环境 中 的 那些 
JAR 不 同时 ， 失 败 的 机 滨 就 会 增加 。 这 些 风险 使 我 确信 ， 为 了 确保 二 进 制 代码 的 完整 性 ， 必 
须 一 次 性 编译 和 打包 ， 以 便 部 署 到 多 个 环境 。 


用 一 次 性 容器 降低 部 署 成 本 

名 称 : Disposable Container 

模式 : 通过 将 安装 和 配置 解 辜 ， 使 Web 和 数据 库容 器 的 安装 和 配置 自动 化 。 
反 模 式 : 手动 将 容器 安装 到 每 个 目标 环境 并 进行 配置 。 


在 较 早 一 期 的 让 开发 自动 化 文章 “持续 集成 反 模 式 ， 第 2 部 分 ”中 ， 谈 到 了 为 什么 清理 一 个 

“ 受 污染 的 ” 环境 有 助 于 防止 出 现 误 判 或 漏 判 的 构建 。Disposable Container 可 以 减少 在 使 用 持 
久 性 容器 时 可 能 出 现 的 很 多 问题 。Disposable Container 模式 基于 两 个 原则 : 完全 移 除 所 有 容 
器 组 件 ， 以 及 将 容器 的 安装 与 配置 分 离 。 对 于 有 些 人 ， 尤 其 是 系统 工程 师 来 说 ， 这 似乎 是 一 


个 极端 的 概念 ， 因 为 不 再 要 求 由 一 个 单独 的 团队 管理 和 模糊 化 容器 ， 不 让 开发 人 员 或 其 他 人 
接触 到 它们 。 然 而 ， 考 虑 到 部 署 期 间 经 常 出 现 的 、 代 价 不 菲 的 问题 ， 它 可 以 让 所 有 团队 成 员 
的 利益 最 大 化 。 


ENRE 


经 常 有 一 些 团队 和 我 说 : “是 的 ， 我 们 已 经 实现 了 自动 化 部 署 。" 当 我 问 一 些 简单 的 问题 时 一 
dium bd A (例如 ant ) 就 可 以 生成 一 个 有 效 的 软件 应 用 程序 吗 ?"_ 回答 通 

是 这 样 的 : “是 的 ， 一 旦 安装 和 配置 好 Web 容器 ..…..”， 或 者 “是 的 ， 一 旦 设置 好 数据 库 ”。 
Pe t Í| 应 该 能 够 从 一 台 和 干净 的 机 器 开始 ， 安 装 Java 平台 和 
Ant (有 一 些 方法 可 以 免除 这 个 步骤 ) ， 然 后 输入 一 条 简单 命令 ， 即 可 得 到 一 个 可 以 正常 工作 
的 软件 应 用 程序 。 如 果 做 不 到 ， 就 不 算是 “一 键 式 " 部 署 ， 并 且 在 部 署 过 程 中 将 出 现代 价 不 菲 
的 人 员 方 面 的 瓶颈 问题 。 


如 图 3 所 示 ，Disposable Container 模式 基于 这 样 一 个 原则 : 一 切 都 应 该 在 系统 中 一 (使 用 


第 1 部 分 中 提 到 的 Repository 模式 ) 一 而 不 是 在 某 个 人 的 头脑 中 。 


图 3. 部 署 期 间 移 除 和 安装 容器 
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清 i 1 中 的 Ant 脚本 从 Internet FR Tomcat ZIP， 移 除 之 前 的 部 署 残 留 的 任何 容器 ， 然 后 解 
安装 和 启动 Tomcat : 


清单 1. 用 Ant 脚本 编写 的 部 署 ， 该 脚本 移 除 、 重 新 安装 、 启 动 和 配置 容器 


<!-- Check to see if Tomcat is running prior to this --> 


«exec executable-"sh" osfamily-"unix" dir-"$(tomcat.home)/bin" spawn="true"> 
«env keyz"NOPAUSE" value="true" /> 
«arg line-"shutdown.sh" /> 
«/exec» 
«delete dir-'"$[tomcat.homej" /> 
«get src-"$[tomcat.binary.urij/$[tomcat.binary.file]" 
dest-"$([download.dirj/$([tomcat.binary.file)" usetimestamp-"true"/-» 
«unzip dest-"$[target.dirj" src-"$[download.dirj/$[tomcat.binary.filej" /> 
«exec osfamily-"unix" executable-"chmod" spawn="true"> 
«arg value="+x" /> 
«arg file-"$[tomcat.homej/bin/startup.sh" /> 
«arg file-"$[tomcat.homej/bin/shutdown.sh" /> 
«/exec» 
«xmltask source-"$[appserver.server-xml.file]" 
dest-"$[appserver.server-xml.filej"» 
«attr pathz"/Server/Service[Qname-'$[s.name)']/Connector[S$[port-'$(c.portj?']" 
attrz'"proxyPort" 
value-"$[appserver.external.portj"/» 
«attr pathz"/Server/Service[$[name-'$[s.namej']/Connector[$[port-'$[c.port]']" 
attr-'"proxyName" 
value-"$[appserver.external.hostj"/» 
«/xmltask» 
<!-- Perform other container configuration --» 


«echo message-"Starting tomcat instance at $[tomcat.home) with startup.sh" /> 
«exec executable-"sh" osfamily-z'"unix" dir-"$[tomcat.home)/bin" spawn="true"> 
«env keyz"NOPAUSE" value="true" /> 

«arg line-"startup.sh" /> 

«/exec» 


通过 使 环境 处 于 已 知 状态 ， 并 以 一 种 受 控 制 的 方式 部 署 容器 ， 可 以 减少 很 多 常见 的 、 引 发 大 
部 分 部 署 难题 的 部 署 错误 。 


在 多 个 外 部 环境 中 运行 命令 


名 称 : Remote Deployment 
模式 : 使 用 一 个 集中 式 机 器 或 集群 将 软件 部 署 到 多 个 目标 环境 。 
模式 : 在 每 个 目标 环境 中 通过 手动 方式 在 本 地 应 用 部 署 。 


一 旦 安装 了 数据 库 和 Web 容器 ， 让 部 署 在 开发 人 员 的 工作 站 上 运行 是 件 非常 简单 的 事情 。 然 
而 ， 开 发 与 生产 之 间 有 着 巨大 的 差异 。 如 果 组 织 有 多 个 项 目 和 不 同 的 目标 环境 (例如 测试 或 
准备 环境 ) ， 那 么 常常 需要 从 一 个 单独 的 环境 集中 地 管理 部 署 : ee ° 团队 
常 使 用 一 台 构 建 服 务 器 来 管理 每 个 目标 环境 的 部 署 。 在 第 1 部 分 中 ， 我 介绍 了 Headless 
Execution 模式 ， 该 模式 采用 公共 和 私有 密 钥 ， HARS ARRAES 。 如 图 4 所 示 ， 
Remote Deployment 依赖 于 Headless Execution、Single Command 和 Scripted 
Deployment 模式 ， 因 此 可 以 方便 地 部 署 到 远程 机 器 : 


图 4. 用 于 多 个 环境 的 构建 管理 服务 器 
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要 从 集中 构建 服务 器 远程 部 署 软件 ， 需 要 使 用 一 些 机 制 安全 地 进行 远程 复制 和 运行 命令 。 我 
将 讨论 的 两 个 机 制 使 用 Secure Copy (SCP) 和 Secure Shell (SSH) 。 如 清单 2 所 ， 在 
Scripted Deployment 模式 下 ， 集 中 构建 机 器 上 生成 的 Web 归档 被 远程 地 复制 到 一 个 目标 环 
境 : 


清单 2. 将 war 文件 安全 地 从 一 台 机 器 复制 到 另 一 台 机 


En: 


«target name-z"copy-tomcat-dist"» 

«scp file-"$[basedirj/target/brewery.war" 
trust-"true" 
keyfile-"$([basedir)/config/id dsa" 
username-"bobama" 

passphrasez"" 


todir-"pduvall:GOtheD!stanceQmyhostname:/usr/local/jakarta-tomcat-5.5.20/webapps" /> 
«/target» 


E ci 


3i WAR 文件 被 安全 地 复制 到 远程 目标 环境 时 ， 我 就 可 以 在 Java Secure Channel 中 使 用 
ssHExec 之 类 的 任务 运行 任何 SSH 命令 ， Mou bae dta 中 远程 执行 的 。 另 一 种 
方法 是 ssh 到 远程 环境 ， 并 在 本 地 运行 这 样 可 以 减少 来 回 的 远程 传输 ， 并 缩短 部 署 时 
间 。 


使 数据 库 和 数据 处 于 已 知 状 态 


名 称 : Database Upgrade 

模式 : 使 用 脚本 和 数据 库 在 每 个 目标 环境 中 应 用 增 量 更 改 。 

反 模 式 : 在 每 个 目标 环境 中 手动 应 用 数据 库 和 数据 更 改 。 

在 图 5 中， 可 以 看 到 一 个 在 Scripted Deployment 中 使 用 自动 化 脚本 更 新 数据 库 的 例子 


图 5. 自动 应 用 增 量 数据 库 更 新 
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RM 期 的 让 开发 自动 化 文章 "实现 自动 化 数据 库 迁 移 ” 中 ， 我 谈 到 了 以 自动 化 的 方式 应 用 
增 量 数据 库 更 改 的 必要 性 。 和 Scripted Deployment 中 的 其 他 部 分 一 样 ， 数 据 库 更 新 脚本 被 签 
入 到 储存 库 中 。 


LiquiBase (参见 参考 资料 ) 是 用 于 将 增 量 更 改 应 用 到 数据 库 的 工具 ， 可 使 同样 的 更 改作 为 
Scripted Deployment 的 一 部 分 应 用 到 每 一 个 目标 环境 。 在 清单 3 中 ， 一 个 SQL 脚本 被 作为 
LiquiBase changelog 的 一 部 分 调用 。 然 后 ，Scripted Deployment (使 用 一 种 构建 脚本 工具 实 
现 一 例如 Ant) 调用 这 个 changelog (使 用 XML 定义 ) 。 


清单 3. 从 LiquiBase 更 改 集 运行 定制 的 SQL 文件 


«changeSet id="1" author="jbiden"> 
<sqlFile path="insert-distributor-data.sql"/> 
«/changeSet» 


要 学 习 和 应 用 自动 化 数据 库 更 新 ， 还 有 相当 多 的 事情 要 做 ， 但 其 主旨 是 在 Scripted 
Deployment 中 执行 更 新 ， 使 所 有 数据 库 更 改 都 在 系统 中 ， 而 不 是 一 个 写 好 的 程序 或 存在 某 个 
人 的 头脑 中 。 


冒 烟 测试 部 署 

名 称 : Deployment Test 

模式 : 将 自 测试 功能 编写 到 Scripted Deployments 中 。 

反 模 式 : 通过 运行 手动 功能 测试 来 验证 部 署 ， 没 有 关注 特定 于 部 署 的 方面 。 
图 6 解释 了 在 部 署 前 后 运行 部 署 测试 的 一 个 例子 


图 6. 对 应 用 程序 运行 功能 部 署 测试 
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在 清单 4 中 ， 我 使 用 Ant 执行 部 署 前 测试 ， 以 确认 正在 使 用 的 版 本 是 正确 的 工具 版 本 。 在 
Scripted Deployment 中 ， 脚 本 可 baa Ed 的 端口 (这 可 能 导致 Web 容器 部 署 失 
K) ， 检 查 与 数据 库 的 连接 ， 检 查 是 否 已 被 启动 ， 以 及 很 多 其 他 内 部 部 署 测 试 。 


清单 4. 运行 部 署 前 检查 ， 确 保 部 署 有 效 


«condition property-z"ant.version.success"» 

«antversion atleast-"$[ant.check.versionj)" /> 

«/condition» 

«antunit:assertPropertyEquals name-"ant.version.success" value="true" /> 
«echo message-"Ant version is correct." /> 

«echo message-"Validating Java version..."/-» 

«condition property-z"java.major.version.correct"» 

«equals argi-"$[ant.java.versionj" arg2-"$[java.check.version.majorj" /> 
«/condition» 
«antunit:assertTrue message-"Your Java SDK version must be 1.5*. \ 

You must install correct version." 

«isset property-"java.major.version.correct"/» 
«/antunit:assertTrue» 


更 全 面 的 部 署 测试 可 以 确保 应 用 程序 的 功能 性 是 正确 的 。 通 过 使 用 用 于 Web 应 用 程序 的 
Selenium 或 用 于 客户 机 应 用 程序 的 Abbot 之 类 的 工具 编写 特定 于 部 署 的 自动 化 功能 测试 ， 可 
以 验证 是 否 已 正确 应 用 了 部 署 更 改 。 可 以 将 这 些 测试 看 作 冒 烟 测试 (smoke tests) : 只 需 测 

试 受 部 署 影响 的 功能 。 例 如 ， 表 1 展示 了 使 用 Selenium 和 其 他 用 于 Web 应 用 程序 的 工具 的 
一 些 方式 : 


表 1. 部 署 测试 


部 署 测试 dil 


编写 一 个 自动 化 功能 测试 ， 该 测试 将 数据 插入 到 


数据 库 。 验 证 数据 是 否 被 输入 到 数据 库 中 。 
简单 邮件 传输 协议 (Simple Mail 编写 一 个 自动 化 功能 测试 ， 该 测试 从 应 用 程序 发 
Transfer Protocol > SMTP) 送 一 个 电子 邮件 消息 。 
使 用 SoapAPI 之 类 的 工具 提交 一 个 Web 服务 ， 
名 
Web 服 2j 并 验证 输 出 
Web 容器 验证 所 有 容器 服务 是 否 正 确 运行 。 
AE ZO ud ; ， . . 和 
轻 量 级 目录 访问 协议 (Lightweight 使 用 应 用 程序 ， 通 过 LDAP 进行 验证 。 


Directory Access Protocol > LDAP) 


编写 一 个 测试 ， 该 测试 使 用 应 用 程序 的 日 志 记录 


去 记录 
d 机 制 编写 日 志 。 


自动 化 测试 不 仅仅 用 于 测试 用 户 功能 。 通 过 创建 侧重 于 部 署 测 试 的 套件 ， 可 以 检验 部 署 的 有 
效 性 ， 减 少 下 游 错 误 和 开发 成 本 。 


回 深 所 有 部 署 更 改 

名 称 : Environment Rollback 

模式 : 当 部 署 失 败 后 ， 提 供 自动 的 Single Command 更 改 回 滚 。 
BIEN : 手动 回 滚 应 用 程序 和 数据 库 更 改 。 


图 7 解释 了 回 滚 数据 库 更 改 一 使 用 Database Upgrade 一 以 及 回 滚 Web 部 署 的 自动 化 过 程 : 


图 7. 回 滚 部 署 更 改 
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不 管 是 否 执行 自动 化 部 署 ， 当 部 署 失 败 时 ， 最 好 有 一 种 方式 可 以 回 滚 更 改 。 在 某 些 情况 下 ， 
蕴 误 的 更 改 可 能 导致 系统 中 断 ， 使 组 织 损失 数 百 万 美元 。 要 执行 Environment Rollback > $% 
要 让 目标 环境 回 到 部 署 前 的 状态 。 为 此 ， 实 际 上 每 个 更 改 都 需要 一 个 回 滚 脚本 。VVeb 部 署 常 
常 需要 回 滚 更 多 的 更 改 。Environment Rollback 的 一 个 例子 是 在 部 署 前 复制 归档 (例如 一 个 
WAR 文件 ) ， 并 为 每 个 更 改 提 供 回 滚 数据 库 脚 本 。 另 外 还 需要 重新 应 用 已 应 用 于 Web 容器 

的 配置 更 改 。 


清单 6 演示 了 一 个 示例 ， 该 示例 使 用 LiquiBase 为 每 个 前 滚 语句 提供 一 个 回 滚 语句 。 我 将 添 
加 一 个 名 为 brewery 的 新 表 ， 同 时 提供 一 个 相应 的 dropTable HRH 4J o 


清单 6. 当 应 用 增 量 数据 更 新 时 提供 回 滚 过 程 


«changeSet id="rollback-database-changes" author="bobama"> 
<createTable tableName="brewery"> 
<column name="id" type="int"/> 
</createTable> 
<rollback> 
<dropTable tableName="brewery"/> 
</rollback> 
«/changeSet» 


这 个 简单 的 例子 仅 用 于 说 明 问 题 ， 并 不 意味 着 回 滚 就 是 这 么 简单 。 恢 复 到 前 一 个 部 署 常常 是 
一 个 复杂 的 、 费 时 的 过 程 (需要 实现 自动 化 ) 。 用 于 编写 回 滚 脚本 的 时 间 应 该 与 部 署 失 败 付 
出 的 代价 成 比例 。 


保护 信息 不 被 窥探 
名 称 : Protected Files 
模式 : 使 用 储存 库 ， 只 允许 经 过 授权 的 团队 成 员 共 享 文件 。 


Antipattern : 在 团队 成 员 的 机 器 上 管理 文件 ， 或 者 将 文件 存储 在 可 由 已 授权 团队 成 员 访问 的 
共享 驱动 器 上 。 


图 8 展示 了 一 个 受 保 护 的 版 本 控制 储存 库 ， 它 用 于 存放 只 有 已 授权 人 员 或 系统 可 以 访问 的 文 
TF : 


图 8. 使 用 受 保护 的 版 本 控制 储存 库存 放 敏 感 文件 
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在 某 些 情况 下 ， 并 不 是 所 有 团队 成 员 都 应 该 访问 特定 于 环境 的 数据 。 但 是 ， 将 该 信息 与 部 署 
脚本 分 离 又 可 能 使 脚本 无 法 执行 。 当 讨论 Headless Execution 模式 时 ， 我 描述 了 使 用 SSH 
密 钥 和 Java Secure Channel 工具 复制 文件 ， 并 安全 地 运行 远程 命令 ， 而 不 需要 人 为 输入 命 
令 。 使 用 Externalized Configuration 处 理 的 属性 很 可 能 包含 不 应 该 让 所 有 团队 成 员 看 到 的 数 
据 。 为 了 确保 实现 Headless Execution， 同 时 防止 .properties 文件 中 的 数据 被 帘 探 ， 我 使 用 
的 技巧 是 将 这 些 文件 签 入 到 一 个 受 保护 的 储存 库 中 。 


在 清单 7 中 ， 我 配置 了 一 个 由 Apache 托管 的 Subversion 储存 库 ， 先 拒绝 所 有 用 户 访 问 某 个 
目录 ， 然 后 显 式 地 添加 某 些 用 户 : 


清单 7. 在 Apache 上 使 用 Subversion 保护 一 个 Subversion 储存 库 


«DirectoryMatch "^/.*/(N.svn)/"» 
Order deny,allow 

Deny from all 

Allow bobama, jbiden,hclinton 
«/DirectoryMatch» 


通过 保护 对 Subversion 储存 库 的 访问 ， 可 以 n Scripted Deployment 设 为 被 允许 的 用 


户 ， 使 其 不 必 输 入 密码 就 可 以 访问 属性 ， 从 而 通过 SSH 密 钥 定义 的 方式 实现 Headless 
Execution ° 


ENRE 


除了 这 份 分 两 部 分 的 系列 文章 中 描述 的 15 个 部 署 自动 化 模式 外 ， 我 还 归纳 了 更 多 的 模式 ， 但 
是 这 15 个 模式 大 概 可 以 应 对 我 遇 到 的 80% 的 部 署 情况 。 每 个 模式 都 是 为 了 帮助 在 每 个 目标 
环境 中 实现 趴 正 的 一 键 式 / 单 命令 部 署 。 硕 望 您 一 切 顺利 | 


结束 语 


这 是 我 的 让 开发 自动 化 系列 的 最 后 一 篇 文章 。 在 两 年 多 的 时 间 里 与 您 一 起 分 享 我 的 经 验 ， 令 
我 感觉 像 在 经 历 一 场 有 趣 的 探险 。 编 写 这 个 系列 的 目的 是 展示 如 何以 及 为 何 自动 化 大 量 软件 
开发 过 程 ， 使 开发 人 员 可 以 将 更 多 的 时 间 花 在 感 兴趣 的 问题 上 ， 而 不 是 将 时 间 浪 费 在 重复 
的 、 容 易 出 错 的 活动 上 。 在 这 个 系列 中 ， 我 演示 了 如 何 自动 化 代码 检查 以 便 适 当地 重 构 、 增 
量 式 地 升级 应 用 程序 数据 库 、 应 用 Continuous Integration 实践 和 工具 、 每 次 更 改 时 运行 自动 
测试 、 生 成 GUI 安装 程序 、 创 建 一 键 式 部 署 、 使 开发 人 员 自 动 生成 文档 、 执 行 依赖 管理 、 利 
用 版 本 控制 储存 库 ， 以 及 有 效 地 使 用 各 种 构建 脚本 和 工具 。 和 希望 您 在 阅读 这 个 系列 时 能 够 充 
满 乐趣 。 


让 开发 自动 化 : 部 署 自 动 化 模式 ， 第 1 部 分 


用 于 实现 简便 部 署 的 模式 


Java™ 部 署 常常 很 混乱 ， 容 易 出 现 错误 ， 需 要 许多 手工 操作 ， 这 会 延误 向 用 户 交 付 软 件 的 时 
间 。 本 文 是 分 两 部 分 的 让 开发 自动 化 系列 文章 的 第 1 部 分 。 在 本 文中 ， 自 动 化 专家 Paul 
Duvall 将 介绍 用 于 开发 可 靠 、 可 重复 且 一 致 的 部 署 流程 的 一 些 关键 模式 ， 帮 助 读者 为 Java 应 
用 程序 生成 简便 的 部 署 。 


软件 部 署 常 常 被 视 为 不 可 避免 的 麻烦 ， 可 以 在 遇 到 它 时 应 付 一 下 ， 以 后 就 不 用 理会 了 。 但 
是 ， 与 开发 周期 的 其 他 部 分 一 样 ， 可 以 并 且 应 该 对 部 署 应 用 软件 工程 原理 。 在 手工 进行 部 署 
时 ， 部 署 是 一 个 重复 且 容 易 出 现 错误 的 流程 。 正 如 可 以 通过 自动 化 构建 来 减少 错误 并 加 快 软 
件 开发 ， 也 可 以 通过 自动 化 部 署 流程 来 减少 错误 和 加 快 软 件 交 付 。 


在 前 面 的 一 期 让 开发 自动 化 “使 用 自动 化 加 速 部 署 " 中 ， 介 绍 了 一 种 把 软件 远程 部 署 到 多 个 目 
标 环境 中 的 技术 。 本 文 在 更 高 的 层面 上 讨论 自动 化 部 署 。 正 如 存在 一 些 用 于 软件 开发 的 模 
式 ， 也 有 一 些 用 于 部 署 的 模式 。 在 过 去 几 年 里 ， 我 一 直 在 收集 和 整理 这 些 模式 。 在 第 1 部 分 
中 ， 我 将 介绍 8 个 部 署 模式 并 提供 相关 示例 : 


。 Repository， 这 个 模式 在 一 个 集中 的 存储 库 中 管理 所 有 配置 文件 ， 这 样 就 可 以 使 用 

Scripted Deployment 生成 有 效 的 软件 

Scripted Deployment， 这 个 模式 通过 脚本 执行 所 有 部 署 操作 ， 这 样 在 执行 部 署 时 就 不 
需要 人 为 干预 

。 Single Command， 这 个 模式 减少 部 署 的 复杂 性 ， 确 保 实现 部 署 流程 的 无 头 执行 
(Headless Execution) 

Tokenize Configuration， 这 个 模式 提供 一 种 可 重复 的 把 可 变 信 息 注入 配置 文件 中 的 方 


法 
e Externalized Configuration， 这 个 模式 可 以 一 次 性 地 输入 在 目标 环境 之 间 有 差异 的 信 
自 


DN 


e Template Verifier， 这 个 模式 帮助 确保 所 有 目标 环境 属性 都 是 相同 的 
e Headless Execution， 这 个 模式 提供 一 种 在 自动 化 流程 中 安全 地 访问 多 台 机 器 的 方法 
e Unified Deployment ， 这 个 模式 帮助 建立 可 以 在 许多 目标 环境 中 运行 的 单一 部 署 脚 本 


第 2 部 分 将 介绍 更 多 的 部 署 模式 。 
关于 本 系列 
作为 开发 人 人员， 我 们 致力 于 为 用 户 自动 化 流程 ; 但 许多 开发 人 员 足 忽 了 自动 化 我 们 自己 的 开 


发 流程 的 机 会 。 为 此 ， 我 们 编写 了 让 开发 自动 化 系列 文章 ， 专 门 探讨 软件 开发 流程 自动 化 的 
实践 应 用 ， 为 您 介绍 何 时 以 及 如 何 成 功 应 用 自动 化 。 


图 1 说 明 本 文 讨 论 的 部 署 模式 之 间 的 关系 : 


图 1. 部 署 自动 化 模式 
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我 将 依次 讨论 每 个 模式 。 在 这 个 过 程 中 ， 您 会 逐渐 理解 图 1 中 显示 的 关系 。 
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把 所 有 文件 提交 给 一 个 版 本 控制 存储 库 


名 称 : Repository 

模式 : 所 有 文件 都 被 提交 给 版 本 控制 存储 库 一 在 部 署 上 下 文中 ， 这 是 指 所 有 配置 文件 和 工 
具 。 

反 模 式 : 一 些 团队 把 这 些 信息 放 在 一 个 具有 访问 控制 的 共享 驱动 器 上 。 其 他 团队 可 能 仅仅 把 
信息 放 在 自己 的 机 器 上 ， 然 后 把 它们 复制 到 目标 环境 中 。 


作为 一 般 规 则 ， 我 建议 开发 团队 签 入 创建 软件 所 需 的 所 有 文件 。 有 时 候 ， 这 个 规则 有 一 些 例 
外 情况 ， 但 是 不 常见 。 在 部 署 上 下 文中 ， 一 些 团 队 错 误 地 认为 服务 器 和 服务 器 配置 是 固定 不 
变 的 资产 。 尽 管 有 时 候 签 入 大 的 二 进 制 代码 比较 困难 ， 但 是 应 该 把 配置 、 数 据 库 脚本 以 及 所 
有 构建 和 部 署 脚 本 提交 给 版 本 控制 存储 库 。 使 用 Repository 模式 对 于 实现 下 面 讨 论 的 
Scripted Deployment 和 Single Command 模式 很 有 帮助 。 


用 脚本 执行 所 有 部 署 流 程 
名 称 : Scripted Deployment 
模式 : 在 脚本 中 编写 所 有 部 署 流程 。 


反 模 式 : 一 些 团 队 可 能 手工 配置 部 署 任务 ， 比 如 安装 和 配置 Web 容器 。 其 他 团队 可 能 使 用 容 

器 提供 的 基于 GUI 的 管理 工具 针对 特定 环境 修改 容器 。 尽 管 这 种 方式 最 初 可 以 简化 配置 的 手 
工 修改 ， 但 是 如 果 要 在 许多 目标 环境 中 频繁 地 执 # 部署 ， 这 就 不 合适 了 。 另 外 ， 在 首次 使 用 
时 ， 基 于 GUI 的 管理 工具 对 于 部 署 非常 有 帮助 。 但 是 ， 因 为 许多 人 必须 重复 执行 这 些 流程 ， 
所 以 这 种 方式 的 可 伸缩 性 很 差 且 容易 出 现 错误 。 


清单 1 通过 实现 Scripted Deployment 模式 对 启动 (或 重新 启动 ) Tomcat Web 容器 的 流程 进 
行 自动 化 。 这 个 流程 是 用 Apache Ant 构建 脚本 语言 编写 的 。 


清单 1. 启动 Tomcat Web 容器 的 示例 


«available file="@{tomcat.home}/server/@{tomcat.server.name}/bin" 
property="tomcat.bin.exists"/> 
<if> 
«isset property="tomcat.bin.exists"/> 
<then> 
«echo message="Starting tomcat instance at @{tomcat.home} with start tomcat" /> 
«exec executable-'Q[tomcat.homej3/server/Q([tomcat.server.namej)/bin/start tomcat" 
osfamily-"unix" /» 
«/then» 
«else» 
«echo message-"Starting tomcat instance at Qftomcat.home) with startup.sh" /> 
«exec osfamily-"unix" executable-"chmod" spawn="true"> 
«arg value="+x" /> 
«arg file-"Q[tomcat.home?/bin/startup.sh" /> 
«arg file-'"Q[tomcat.home)/bin/shutdown.sh" /> 
«/exec» 


«exec executable-'"sh" osfamily-z"unix" dir-"Qftomcat.home)l/bin" spawn="true"> 
«env keyz"NOPAUSE" value="true" /> 
«arg line-"startup.sh" /> 

«/exec» 


«exec osfamily-"windows" executable-z"cmd" dir-"Q[tomcat.homej)/bin" spawn-"true" > 
«env keyz"NOPAUSE" value="true" /> 
«arg linez"/c startup.bat" /> 
«/exec» 
«sleep seconds-"15" /> 
«/else» 
</if> 


通过 脚本 执行 这 个 流程 ， 就 不 再 需要 在 Tomcat 提供 的 Jr 操作 。 另 外 ， 因 
为 这 个 流程 已 经 脚本 化 了 ， 可 以 在 全 面 的 自动 化 部 署 中 通过 无 头 流程 运行 它 。 


通过 单一 命令 运行 部 署 
名 称 : Single Command 
模式 : 部 署 者 或 无 头 流程 只 需 输入 单一 命令 ， 即 可 为 用 户 生成 有 效 的 软件 。 


反 模 式 : 某 些 部 署 流程 要 求 部 署 者 输入 多 个 命令 并 完成 多 个 流程 ， 比 如 复制 文件 、 修 改 配置 
文件 、 重 新 启动 服务 器 、 EP ， 这 些 重 复 的 操作 很 容易 出 现 错误 。 如 果 他 们 走运 ， 
手头 有 详细 的 文档 ， 能 够 指导 他 们 执行 这 些 操 作 。 但 是 无 论 如 何 ， 要 求人 员 执 行 部 署 流程 都 


会 增加 出 错 的 风险 ， 导 致 时 间 瓶 颈 ， 延 误 软 件 在 多 个 目标 环境 中 的 发 布 。 


开发 环境 不 等 于 生产 环境 


即使 软件 能 够 在 开发 环境 或 QA TET Po o 在 生产 环境 中 正常 工作 ， 
因为 环境 之 间 可 能 存在 各 种 差异 。 这 就 是 为 什么 通过 脚本 执行 所 有 部 署 工作 是 很 重要 的 。 


在 编写 部 署 时 ， 您 的 客户 常常 是 团队 、 组 织 和 公司 中 的 其 他 人 一 甚至 可 能 是 计算 机 。 运 行 部 
署 的 方法 越 复 杂 ， 别 人 或 无 头 流 程 成 功 执行 它 的 可 能 性 就 越 小 。 清 单 2 给 出 一 个 简单 的 单一 
命令 部 署 示 例 : : 


清单 2. 使 用 Ant 执行 单一 命令 部 署 


ant -Dproperties.file-$USERHOME/projects/petstore/properties/dev-install.properties \ 
deploy:remote:install 


清单 2 中 的 命令 执行 一 个 名 为 deploy:remote:install 的 Ant 任务， 并 传递 一 个 与 环境 相关 
的 .properties 文件 ， 从 而 把 软件 远程 NIS EM TUUS 这 个 任务 执行 的 操作 包括 使 用 
Secure Copy protocol (SCP) 安全 地 复制 文件 ; 通过 Secure Shell (SSH) 在 远程 计算 机 上 人 安 
全 地 执行 命令 ; 安装 、 配 置 和 重新 启动 Web 容器 ; 以 及 其 他 流程 一 这些 都 不 需要 人 为 干 
预 。 显 然 ， 用 户 可 以 输入 这 个 命令 ; 但 是 因为 它 非常 简单 ， 所 以 很 容易 通过 无 头 流 程 (比如 
持续 集成 或 构建 管理 服务 器 ) 运行 它 。 


名 称 : Tokenize Configuration 


模式 : 把 标记 化 的 值 输入 配置 文件 ， 然 后 在 Scripted Deployment 期 间 根 据 Repository 中 的 
Externalized Configuration 属性 替换 它们 。 


反 模 式 : 把 与 目标 相关 的 数据 输入 每 个 环境 中 的 配置 文件 。 


清单 3 中 的 XML 文件 用 来 管理 Web 容器 和 数据 库 服务 器 之 间 的 配置 。 在 这 个 文件 中 ， 我 使 
用 o 符号 设置 了 一 些 标记 。 在 自动 化 部 署 期 间 ， 一 个 脚本 将 把 这 些 标记 替换 为 来 自 
Externalized Configuration 文件 的 实际 值 。 


清单 3. 标记 化 的 Web 容器 配置 文件 


«datasources» 

«local-tx-datasource» 
«jndi-name»Qapplication.context.nameQ«/jndi-name» 
«use- java-context»false«/use-java-context» 
«connection-url»Qdatabase.urlQ«/connection-url» 
«user-name»Qdatabase.user(Q«/user -name> 
«password»20database.passwordQ«/password» 
«driver-class»Qdatabase.driverQ«/driver-class» 

«/local-tx-datasource» 

«/datasources» 


把 与 环境 相关 的 值 标记 化 ， 就 使 Scripted Deployment 能 够 通过 Unified Deployment 支持 多 
个 环境 。 


提取 所 有 与 环境 相关 的 属性 


名 称 : Externalize Configuration 
模式 : 把 所 有 可 变 值 从 应 用 程序 配置 转移 到 构建 时 属性 中 。 
反 模 式 : 一 些 团 队 为 每 个 目标 环境 手工 硬 编 码 这 些 值 ， 或 者 使 用 GUI 工具 执行 同样 的 工作 。 


清单 4 给 出 一 些 常常 包含 在 与 应 用 程序 相关 的 配置 文件 中 的 属性 。 通 过 把 所 有 可 变 值 集中 在 
一 个 .properties 文件 ， 就 可 以 把 数据 (T EAE) 与 行为 (部署 脚 本 ) DAH o JAE 
无 论 在 哪个 目标 环境 中 ， 自 动 化 部 署 流程 都 以 相同 的 方式 运行 


清单 4. 可 以 提取 到 与 应 用 程序 相关 的 文件 中 的 示例 属性 


authentication.type-db 
application.url-http://$[tomcat.server.hostname):$[tomcat.server.port)/brewery-webapp 
database .type=mysql 

database.server-localhost 

database.port-3306 

database .name=mydb 

database.userzmyuser! 

database.passwordzmypa$$! 
database.url-jdbc:mysq1://$(database.serverj3:$[database.port)/$([database.name) 
tomcat.server.hostname-localhost 

tomcat.server.name-default 

tomcat.web.password-pa$$123! 

tomcat.cobraorb.port-12748 


清单 4 中 的 值 常常 分 散在 源 代 码 、 服 务 器 配置 、 XML ^ properties 和 其 他 文件 中 。 另 外 ， 我 
发 现 这 些 数据 常常 在 系统 中 重复 出 现 ， 这 会 导致 难以 调试 的 部 署 问题 。 通 过 把 这 些 信息 从 许 
多 地 方 集中 到 一 个 .properties 文件 中 ， 可 以 减少 发 生 部 署 问 题 的 可 能 性 。 


通过 过 无 头 执 行 减 9 7 À 麻烦 


名 称 : Headless Execution 
模式 : 安全 地 与 多 台 计 算 机 进行 交互 ， 而 不 需要 输入 任何 命令 。 


反 模 式 : 由 人 以 不 同 的 用 户 身份 手工 登录 并 访问 每 台 计 算 机 ， 然 后 执行 复制 文件 、 配 置 值 等 
操作 。 


尽管 “无 头 执 行 " 这 个 名 称 有 点 儿 奉 张 ， 但 是 在 需要 通过 自动 化 流程 远程 访问 其 他 计算 机 时 ， 
无 头 执行 确实 是 很 有 效 的 解决 方案 。 通 过 使 用 公共 密 钥 基础 结构 (PKI)， 可 以 把 通常 由 开发 人 
员 、 构 建 工 程 师 、 软 件 配置 管理 (SCM) 或 操作 员 执 行 的 命令 组 合 为 自动 化 的 解决 方案 。 在 图 
2 中 ， 在 构建 计算 机 和 SSH 上 安装 一 个 私有 密 钥 文件 。 在 每 个 与 目标 相关 的 properties 文件 
中 定义 具体 值 。 这 通常 包括 私有 密 钥 文件 名 和 位 置 、SSH 端口 号 和 主机 名 。 目 标 计 算 机 包含 
公共 SSH 密 钥 文件 ， 从 而 完成 SSH 握手。 


图 2. 使 用 SSH X41 X: 3i Headless Execution 模式 
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如 果 使 用 这 种 方式 ，Scripted Deployment 就 可 以 从 构建 环境 对 目标 环境 执行 部 署 流程 ， 不 需 
要 人 为 干预 。 














检查 在 不 同 的 环境 中 属性 是 否 相同 
名 称 : Template Verifier 
模式 : 创建 一 个 模板 文件 ， 所 有 目标 环境 属性 都 基于 这 个 文件 。 


反 模 式 : 一 些 团队 执行 手工 检查 、 举 试 和 纠 错 〈 在 部 署 失败 时 ， 检 查 失 败 的 原因 ) ， 或 者 把 
文件 “隐藏 " 在 计算 机 上 。 


问题 在 于 ， 需 要 确保 在 每 个 环境 中 具有 完全 相同 的 属性 。 但 是 ， 在 自动 化 环境 中 如 何 检查 这 
一 点 呢 ? 根据 一 个 模板 .properties 文件 检查 所 有 目标 环境 文件 ， 就 可 以 确保 所 有 属性 在 任何 
目标 环境 中 都 是 相同 的 。 在 图 3 中 ， 构 建 脚本 运行 一 个 Ant 任务 ， 此 任务 对 
template.properties 和 与 目标 相关 的 .properties 文件 (dev.properties、qa.properties 等 ) 中 
的 属性 (而 不 是 值 ) 进行 比较 。 如 果 发 现 差异 ， 部 署 就 会 失败 。 


图 3. Template Verifier 模式 的 实现 





template.properties | 


Compare 
attributes custom 
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dev properties 
qa. properties 
stage. properties 


清单 5 给 出 一 个 示例 template.properties 文件 。 注 意 ， 它 只 包含 属性 ， 因 为 值 与 这 个 问题 无 






build.xml F - - - -> 




















清单 5. 包含 属性 但 不 包含 值 的 模板 文件 


db.database- 
db.username- 
db.password- 
db.hostname- 
db.driver- 
db.port- 
db.url- 


El 
3 


6 给 出 dev.properties (或 qa.properties 等 ) 文件 的 片段 。 注 意 ， 它 既 包含 属性 ， 也 8, 
含 值 。 这 些 值 是 与 目标 环境 相关 的 。 


清单 6. 基于 模板 文件 的 目标 环境 属性 文件 


db.database-brewery 

db.username-root 

db.password-pQssword 

db.hostname-devi.domain.com 

db.driver-com.mysql.jdbc.Driver 

db.port-3306 
db.url-jdbc:mysq1://$(db.hostname3:$4fdb.port3/$[db.database) 


同时 在 多 个 目标 环境 中 执行 部 署 
名 称 : Unified Deployment 
模式 : 创建 能 够 在 不 同 的 平台 和 目标 环境 中 运行 的 单一 部 署 脚本 。 
模式 : 一 些 团队 为 每 个 目标 环境 (甚至 特定 的 计算 机 ) 使 用 不 同 的 部 署 脚 本 。 


尽管 一 些 部 署 流程 只 在 某 些 环境 中 运行 ， 但 是 所 有 流程 应 该 能 够 在 任何 目标 环境 中 运行 。 例 
如 ， 在 开发 、 测 试 、 准 备 和 生产 环境 中 应 该 运行 相同 的 Scripted Deployment， 但 是 使 用 不 同 
的 Externalized Configuration 文件 。 使 用 Template Verifier 检查 Externalized Configuration 
属性 。 


图 4 给 出 一 个 能 够 在 多 个 目标 环境 中 执行 部 署 的 部 署 脚 本 : 


图 4. 单一 部 署 ， 多 个 目标 环境 
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部 署 是 软件 开发 中 另 一 个 适合 自动 化 的 方面 。 自 动 化 部 署 可 以 受益 于 可 靠 且 可 重复 的 流程 : 
提高 准确 性 、 速 度 和 控制 能 力 。 在 本 文中 ， 我 讨论 了 8 个 适用 于 软件 部 署 自动 化 的 模式 。 第 
2 部 分 将 讨论 更 多 的 模式 ， 包 括 Remote Deployment、Disposable Containers、Deployment 
Test 和 Environment Rollback » 


让 开发 自动 化 : 使 用 基于 向 导 的 安装 程序 


使 用 IzPack 生成 GUI 安装 程序 


对 于 大 多 数 用 户 来 说 ， 安 装 软 件 常常 是 一 件 痛 苦 的 事情 。 生 成 安装 包 是 软件 开发 的 “最 后 一 
步 "， 但 它 可 能 导致 不 同 的 结果 : 要 么 用 户 采用 软件 ， 要 么 它 就 成 为 无 人 问津 的 垃圾 品 。 在 本 
期 的 让 开发 自动 化 中 ， 自 动 化 专家 Paul Duvall 演示 了 如 何 使 用 免费 、 开 源 的 工具 IzPack 来 
编写 为 您 的 用 户 安装 软件 的 基于 向 导 的 安装 程序 。 


在 我 职业 生涯 的 大 部 分 时 间 里 ， 我 参与 了 软件 开发 的 整个 生命 周期 一 不 仅 设 计 软 件 的 需求 、 
设计 、 开 发 和 测试 ， 还 涉及 部 署 、 构 建 管理 、 文 档 编制 和 安装 等 活动 。 最 近 ， 随 着 敏捷 开发 
越 来 越 流行 ， 这 些 活动 可 能 会 更 加 规范 。 然 而 ， 我 在 敏捷 项 目 方面 的 经 验 表明 ， 有 效 的 部 署 
和 安装 并 没有 受到 同等 的 重视 。 这 很 滑 稿 ， 因 为 如 果 潜 在 用 户 不 能 轻松 地 安装 您 的 软件 ， 那 
么 您 很 可 能 会 失去 他 们 。 提 供 一 种 简单 的 方式 来 安装 您 的 软件 ， 这 对 于 吸引 和 留 住 用 户 至 关 
重要 。 


关于 本 系列 


作为 开发 人 员 ， 我 们 致力 于 为 用 户 自动 化 流程 ; 但 许多 开发 人 员 鸣 忽 了 自动 化 我 们 自己 的 开 
发 流程 的 机 会 。 为 此 ， 我 们 编写 了 让 开发 自动 化 系列 文章 ， 专 门 探讨 软件 开发 流程 自动 化 的 
实践 应 用 ， 为 您 介绍 何 时 以 及 如 何 成 功 应 用 自动 化 。 


这 些 年 来 ， 我 使 用 过 很 多 安装 程序 工具 。 我 们 团队 在 今年 年 初 开始 的 一 个 大 型 项 目 中 ， 为 了 
创建 企业 级 安装 程序 ， 必 须 满足 一 些 非常 特别 的 需求 。 我 们 看 过 Antigen、Antlnstaller、 
Denova ` install4j ` InstallAnywhere ` IzPack ` NSIS 等 工具 。 但 是 根据 项 目的 特定 需求 ， 我 
们 最 后 决定 使 用 lzPack， 因 为 : 


e 它 可 以 在 多 种 平台 上 运行 。 我 们 需要 支持 Windows@、Linux@ 和 Macintosh 。 

e IzPack 使 用 Java™ 语 言 ， 而 我 们 团队 对 于 这 种 语言 有 丰富 的 经 验 。 

e 它 可 以 执行 Apache Ant 脚本 。 我 们 已 经 花 了 大 量 的 时 间 为 软件 部 署 而 编写 Ant 脚本 。 
e IzPack 可 免费 下 载 。 


IzPack 在 2001 年 已 经 出 现 。 它 为 创建 基于 向 导 的 安装 程序 提供 了 一 套 丰 富 的 特性 。 在 本 文 
中 ， 我 演示 如 何 使 用 该 工具 创建 安装 程序 ， 并 给 出 定义 面板 、 用 脚本 编写 验证 器 、 设 置 资源 
等 方面 的 例子 。 


下 载 和 安装 IzPack 


IzPack 文档 


要 仔细 查看 的 第 一 个 子 文件 夹 是 doc 文件 夹 。 4- HTML ` PDF 和 Javadoc 版 本 的 文档 ， 
当 您 查阅 如 何在 IzPack 中 编写 脚本 时 ， m 您 忠实 的 伙伴 。 


下 载 和 安装 IzPack 3E € f$ 3- » IzPack 使 用 IzPack 来 安装 lzPack， 这 也 许 并 不 奇怪 。 请 访问 
IzPack 网站， 下 载 IzPack JAR 文件 (请 参阅 参考 资料 ) 。 


要 安装 |zPack， 必 须 有 一 个 正在 运行 的 Java Runtime Environment (JRE) 。 打 开 命 令 行 提 
示 符 ， 输入 java -jar IzPack-install-4.1.0.jar ， 可 以 根据 需要 修改 版 本 x 


基于 向 导 的 安装 程序 要 求 提 供 基 本 的 安装 信息 ， 比 如 想 将 IzPack 安装 在 哪里 。|zPack 安装 完 
毕 后 ， 将 得 到 一 个 可 以 运行 的 示例 安装 程序 。 


修改 示例 脚本 


EE 提供 了 一 套 完 整 的 示例 安装 脚本 。 以 它们 为 基础 编写 自己 的 安装 程序 ， 这 是 获得 一 个 
了 的 安装 程序 的 最 快 方法 。 安 装 IzPack 的 根 目录 下 有 一 些 子 目录 ， 包 括 bin ^ doc f» lib 
ee sample 中 ， 实 际 上 它 包含 了 开发 您 自己 的 安装 程序 所 需 的 所 有 
西 。 我 选择 复制 这 个 sample 目录 ， 这 样 就 可 以 随意 修改 它 ， 而 不 会 破坏 原始 的 内 容 。 图 1 
显示 了 sample 目录 的 内 容 : 


RE 


图 1. IzPack 文件 的 文件 列表 


doc File Folder 
listener File Folder 

src File Folder 

la antActionSpec. xml 3KB  EditPlus XML (.xml) 
|á) install. jar 609KB Executable Jar File 
[€] install. xml 4KB EditPlus XML (xml) 
自 Licence,txt 1KB Text Document 

(2) Readme.txt 1KB Text Document 
图 :cript,bat 1KB MS-DOS Batch File 
[e] userInputSpec.xml 29KB  EditPlus XML (.xml) 


下 面 是 对 图 1 中 列 出 的 每 个 文件 的 描述 : 


。 antActionSpec.xml : 执行 与 构建 相关 的 Ant 脚本 的 文件 。 

。 install.jar : IzPack 编译 期 间 生 成 的 JAR 安装 文件 。 这 是 用 户 运行 的 安装 程序 文件 。 

e install.xml : IzPack 的 主 安装 脚本 。lzPack 安装 程序 中 使 用 的 所 有 资源 都 以 这 个 脚本 开 
始 。 

e Licence.txt : 安装 程序 的 许可 文件 。 

。 Readme.txt : 软件 用 户 使 用 的 readme 文件 。 

e userlnputSpec.xml : IzPack 特有 的 XML 脚本 ， 用 于 定义 用 户 在 一 个 安装 程序 面板 中 输 
入 信息 时 的 行为 (验证 、 默 认 值 、 字 段 大 小 等 ) 。 


接 下 来 ， 通 过 查看 install.xml 脚本 仔细 研究 IzPack 。 


通过 资源 定义 不 同 的 脚本 、 图 像 、 许 可 和 其 他 文件 ， 它 们 共同 构成 我 将 要 创建 的 安装 程序 。 
我 在 install.xml 脚本 中 定义 了 一 个 &lt;resources&gt; XML 元素 。 在 &lt;resources&gt; 元 素 
下 ， 我 可 以 定义 安装 程序 将 使 用 的 多 个 文件 ， 如 清单 1 所 示 : 


清单 1. 在 IzPack install.xml 中 定义 资源 文件 


«resources» 
«res id-z"LicencePanel.licence" src-z'"Licence.txt"/» 
«res id-z"InfoPanel.info" srcz"Readme.txt"/» 
«res id-"AntActionsSpec.xml" src-"antActionSpec.xml" /> 
«res id-"userInputSpec.xml" src-"userInputSpec.xml" /> 
«/resources» 


可 以 将 IzPack 的 资源 看 作 安装 程序 的 "原料 单 "， 其 中 定义 了 用 于 安装 程序 的 所 有 文件 。 


面板 


面板 是 用 户 在 安装 向 导 的 每 一 步 中 看 到 的 东西 。|zPack 提供 了 很 多 类 型 的 开 箱 即 用 的 面板 ， 
您 可 以 根据 自己 的 需求 定制 它们 。 在 图 2 中 ， 我 定制 了 IzPack 的 Hellopanel ， 以 便 向 用 户 
提供 介绍 信息 : 


图 2. IzPack 提供 的 定制 的 基于 向 导 的 GUI 安装 
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= Welcome to the installation of Automation for the People Installation 1.2! 
( This software is developed by: 

- Paul Duvall «paul.duvall&stelligent.com 
(ll; The homepage is at: hktp:]/www. stelligenk.corn] 


(Made with IzPack- http://izpack.org/) 一 





标准 面板 包括 LicensePanel ^ UserInputPanel 和 PacksPanel 等 。 i install.xml 文件 中 ， 可 
以 使 用 &lt;panels&gt; 元 素 定 义 要 显示 的 面板 ， 然 后 再 定义 编写 安装 程序 时 将 使 用 的 面板 模 
板 。 清 单 2 中 的 例子 演示 了 如 何 定义 面板 模板 : 


«panels» 

«panel classname-"HelloPanel"/- 

«panel classname-"InfoPanel"/» 

«panel classname-"LicensePanel"/» 

«panel classname-"UserInputPanel" id-"UserInputPanel.0" /> 
«panel classname-'"TargetPanel"/» 

«panel classname-'PacksPanel"/» 

«panel classname-"InstallPanel'/» 

«panel classname-'"FinishPanel"/» 

«/panels-» 


您 最 常用 的 是 模板 类 型 可 能 是 UserInputPanel ° 3X pu 可 以 输入 可 变 信 息 而 定制 的 面板 
模板 。 这 包括 用 户 的 联系 方式 信息 、 认 证 凭证、 目录 位 置 等 。 用 户 可 能 需要 根据 他 们 特定 的 
环境 在 面板 上 输入 信息 。 由 于 我 们 的 团队 需要 用 户 连 接 到 并 设置 多 个 JBoss 容 

器 ， 所 以 我 们 使 用 面板 提示 用 户 提供 特定 的 信息 。 


清单 3 是 从 userlnputSpec.xml 摘录 的 一 个 例子 ， 在 清单 1 中 我 将 它 定义 为 一 个 资源 。 在 这 
个 例子 中 ， 我 将 收集 特定 于 用 户 的 信息 ， 用 于 连接 到 一 个 特定 的 数据 库 。 


清单 3. 定义 安装 程序 中 的 面板 的 属性 


«panel order="0"> 

«field type-"title" txt-"Configuring your database connection" bold-'"true" size="1" /> 
«field type-"staticText" align="left" txt-'"Connect to an existing database..."/» 
«field type-"divider" align-"top"/» 


«field type="text" variable-"database.hostname"- 
«spec txt-"Database Host Name:" id-"databasehostname.label" size="40" set=""/> 
«validator class-"com.izforge.izpack.util.NotEmptyValidator" 
txt-" Database Hostname is a required field" /» 
</field> 
«/panel» 


可 


该 面板 的 order 属性 被 设置 为 0 ， 这 对 应 于 清单 2 中 的 面板 集合 中 定义 的 
UserInputPanel 的 数量 。 


在 用 户 输入 面板 中 ， 可 以 为 用 户 定义 信息 文本 。 而 且 ， 我 加 入 了 一 个 NotEmptyvalidator ， 它 
要 求 用 户 在 文本 域 中 输入 一 个 值 。 这 样 可 以 防止 因 用 户 忘 记 输 入 必需 的 信息 而 导致 安装 错 
误 。 图 3 中 显示 了 基于 清单 3 的 UserInputPanel 


图 3. 供用 户 输 入 信息 的 面板 
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Configuring your MySQL database connection 


Connect to an existing MySQL database. 











Database Host Name: | 

Database Port: 3306 | 
Database Name: aftp. db 

Database Application User: | aftpuser 





Database Application User Password: 
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用 户 常常 根据 输入 信息 和 显示 消息 的 难 易 程度 来 判断 安装 程序 的 好 坏 。 因 此 一 定 要 让 用 户 看 
到 的 东西 容 多 使 用 。 


pack 


IzPack 使 用 术语 pack 表 示 负 责 实际 安装 开发 团队 已 实现 的 软件 的 组 件 。 所 有 其 他 的 IzPack 
组 件 (面板 、 用 户 输入 、 验 证 器 等 ) 都 是 为 运行 这 些 pack 做 准备 。 我 的 项 目 使 用 pack 做 两 
OO 安装 发 布 包 ， 然 后 运行 这 个 安装 。 这 种 方法 使 
我 们 可 以 重用 之 前 编写 的 在 命令 行 运行 的 命令 。 清 单 4 定 义 了 一 个 &lt;packsgt; 


清单 4. 在 install.xml 中 定义 一 个 &lt;pack&gt; 


<packs> 
«pack name-"download install" id-"download install" 
installGroups-"ap" required-"no"» 
«description»The base files«/description- 
«file src-"autopeople.zip.file" 
targetdir-"$SYSTEM user home/ cnnewi cnnewi1Q[installer.dirj"/» 
«file src-'"build.xml" 
targetdir-"$SYSTEM user home/Qfinstaller.dirj"/» 
«file src-"property-template" 
targetdir-"$SYSTEM user home/Qfinstaller.dirj"» 
«excludes»**/.svn/**«/excludes» 
«/file» 
«/pack» 





图 4 显示 一 个 进行 中 的 pack 安装 


图 4. 执行 一 个 pack 
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18$ Pack installation progress: 
| [Finished] 


18 Overall installation progress: 
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IzPack 中 的 packs 可 以 包含 多 个 pack ! 如 果 您 已 经 
的 信息 等 前 期 工作 ， 那 么 用 户 应 该 很 容易 运行 安装 包 。 


运行 Ant 脚本 


在 我 的 团队 中 ， 我 们 花 了 很 多 时 间 用 Ant 创建 基于 发 布 包 的 安装 程序 。 我 们 不 想 在 IzPack 中 
再 次 重新 实现 该 功能 。 幸 运 的 是 ，lzPack 支持 调用 已 有 Ant 文件 。 还 记得 吗 ， 我 在 清单 1 中 
定义 资源 时 ， 曾 列 出 了 antActionSpec.xml 作为 一 个 资源 。 清 单 5 显示 了 摘自 
antActionSpec.xml 脚本 的 一 个 片段 : 


清单 5. 在 antActionSpec.xml 中 执行 pack 行为 


«antactions» 
«pack name-"download install"-» 
«antcall buildfile-"$SYSTEM user home/$[installer.dirj/build.xml" 
order-"afterpack" 
verbose-z"yes" 
logfile-"$SYSTEM user home/$[installer.dirj/antlog installer.txt" 
inheritall-"false" 
messageid-"AntAction.download-install"- 
«target name-"install"/» 
«property name-"install.path" value-z"$SYSTEM user home/$[installer.dirj"/» 
«/antcall» 
«/pack» 


«/antactions» 


这 个 脚本 中 最 重要 的 执行 build.xml 的 部 分 。 这 是 现 有 的 Ant 构建 脚本 ， 它 执行 下 载 和 提取 
一 个 ZIP 安装 文件 ， 安 装 并 配置 Web 容器 ， 然 后 完成 安装 中 剩 下 的 其 他 任务 
antActionSpec.xml BATTLE S Ant 脚本 。 


最 后 一 步 就 是 IzPack 的 编译 。 编 写 好 install.xml 和 相关 脚本 之 后 ， 就 可 以 生成 安装 程序 。 清 
单 6 是 一 个 可 用 于 生成 install.jar (可 以 修改 这 个 文件 的 文件 名 ) 的 单行 命令 的 例子 


清单 6. 创建 一 个 安装 程序 


compile ../sample/install.xml -b ../sample 


清单 6 中 的 命令 假设 您 是 从 IzPack 的 bin 子 目 录 运 行 它 。 sample 是 对 IzPack 提供 的 
sample 子 目 录 的 引用 。 生 成 安装 程序 后 ， 可 以 通过 从 s em 子 目 录 中 生成 install.jar 的 位 置 
运行 java -jar install.jar 来 测试 它 。 


结束 语 


在 本 文中 ， 我 展示 了 如 何 使 用 IzPack 的 不 同 组 件 为 用 户 创建 易于 使 用 的 安装 包 。 他 们 可 能 是 
安装 基于 客户 机 的 软件 的 用 户 ， 也 可 能 是 安装 和 配置 多 个 服务 器 的 远程 站 点 的 用 户 ， 还 可 能 
是 安装 和 配置 企业 工具 套件 的 团队 。 如 果 软 件 容 易 安 装 ， 则 更 易 被 采纳 ， 这 一 点 在 安装 比较 
复杂 的 环境 中 尤为 突出 。 如 果 安 装 需要 很 多 手动 步骤 或 者 干脆 无 法 进行 ， 那 么 用 户 很 快 就 会 
对 软件 失去 信心 。 通 过 |zPack 等 工具 使 安装 变 得 更 加 容易 ， 这 可 以 帮助 您 赢得 并 留 住 热情 的 
用 户 。 


让 开发 自动 化 : 针对 广大 开发 人 员 的 并 行 开 发 


Subversion 中 的 分 支 、 标 记 和 合并 


虽然 很 多 开发 团队 都 使 用 版 本 控制 系统 管理 代码 变更 ， 但 当 多 个 开发 人 员 并 行 地 使 用 不 同 的 
代码 库 进行 编码 时 ， 还 是 会 出 现 问 题 的 。 在 本 期 的 让 开发 自动 化 中 ， 自 动 化 专家 Paul Duvall 
展示 了 如 何 运 用 开源 的 、 免 费 的 Subversion 版 本 控制 系统 来 有 效 地 进行 标记 、 分 支 和 合并 。 


说 到 源 代 码 分 支 ， 可 以 将 大 多 数 的 软件 开发 团队 大 致 划 分 为 两 大 阵营 : 有 些 是 根本 不 分 支 
或 存在 大 量 的 分 支 (其 至 储存 库 ) ， 以 致 开发 人 员 不 知道 从 哪里 签 入 变更 一 或 者 觉得 合 合并 变 
更 很 痛苦 ， 于 是 就 冒险 将 这 项 工作 推迟 到 软件 快要 发 布 时 才 做 。 


Ad 


主干 (trunk) (有 时 称 head) 用 于 干线 开发 (mainline development) » 2: X (branch) 是 
指 一 个 代码 支线 副本 ， 用 于 进行 与 干线 开发 不 同 的 变更 。 标 记 (tag) (有 时 称 标签 ) 是 一 个 
使 用 时 间 改 的 代码 支线 副本 ， 用 于 标识 代码 支线 ， 以 在 开发 周期 中 返回 到 标记 的 地 方 。 


远 只 需要 操作 主干 是 最 理想 的 情况 。 这 使 合并 两 个 或 多 个 代码 支线 间 的 变更 没有 那么 复 
EX 在 现实 的 软件 开发 中 ， 您 正在 开发 的 可 能 是 未 来 版 本 ， 或 者 有 时 您 可 能 需要 为 一 
个 已 经 交付 使 用 的 版 本 准备 一 条 后 路 。 你 需要 有 权限 访问 已 发 布 版 本 的 源 代码 副本 一 但 又 不 
能 扰乱 正在 开发 的 新 代码 。 


但 当 开 发 团队 试图 使 用 分 开 的 代码 支线 时 ， 问 题 就 会 出 现 了 。 有 些 时 候 ， 开 发 团队 可 能 会 选 
择 不 创建 分 支 ， 免 得 会 延误 发 布 或 导致 开发 人 员 瓶 颈 。 而 有 些 时候 ， 开 发 人 员 合 并 的 频率 太 
低 ， 结 果 导 致 了 合并 冲突 、 瓶 颈 以 及 发 布 延误 。 而 增加 分 支 则 会 使 导航 项 目 储存 库 很 困难 ， 
从 而 导致 开发 人 员 无 意 中 更 改 了 不 应 该 更 改 的 代码 。 


团队 进行 并 行 开发 时 ， 一 定 要 以 最 高 的 频率 将 代码 合并 回 干线 (PEF) 。 如 果 无 法 经 常 将 
代码 合并 到 主干 的 话 ， 可 以 运行 测试 ， 这 样 就 能 够 确定 是 否 会 发 生 合并 冲突 ， 从 而 使 实施 合 
并 没有 那么 困难 。 要 有 效 地 进行 并 行 开 发 ， 您 可 以 使 用 n (SVN) 中 的 标记 和 分 
支 ，Subversion 是 一 个 开源 的 、 免 费 的 源 代 码 管 理 系统 。 通 过 标记 ， 团 队 可 以 安全 地 返回 到 
源 代码 的 前 一 版 本 中 。 


我 将 通过 介绍 以 下 内 容 来 示范 如 何在 SVN 中 进行 并 行 开发 : 


e. 如 何 从 主干 创建 一 个 SVN 版 本 标记 

e 根据 版 本 标记 来 创建 一 个 SVN 分 支 

e 将 变更 合并 回 干 线 PET) 的 技巧 

e 如 何在 开发 中 的 主干 运行 持续 集成 (Continuous Integration > CI) ， 以 定期 测试 分 支 与 
主干 的 合并 


演示 如 何 将 源 于 分 支 的 变更 应 用 到 主干 
o 举例 说 明 如 何 标 记分 支 的 源 代码 


关于 本 系列 


作为 开发 人 人员， 我 们 致力 于 自动 化 用 户 流程 ; 但 许多 开发 人 员 却 足 忽 了 自动 化 自己 的 开发 流 
程 。 为 此 ， 我 们 编写 了 让 开发 自动 化 系列 文章 ， 专 门 探讨 软件 开发 流程 自动 化 的 实际 应 用 ， 
为 您 介绍 何 时 以 及 如 何 成 功 应 用 自动 化 。 


图 1 显示 了 几 个 并 行 代码 支线 的 基本 流程 : 


图 1. 并 行 开发 





在 图 1 中 ， 有 效 的 开发 发 生 在 SVN 主干 的 版 本 1.0.0 和 版 本 1.1.0 之 间 。 可 以 是 一 组 开发 人 
员 在 版 本 1.0.1 分 支 上 进行 开发 ， 而 其 他 人 员 在 干线 上 开发 。 


如 果 想 要 多 个 开发 人 员 负 责 不 同 的 代码 支线 的 话 ， 可 以 使 用 很 多 策略 和 技巧 。 在 本 文中 ， 我 
将 展示 一 个 很 常用 的 方法 ， 我 曾 在 使 用 SVN 的 项 目 上 用 过 它 


为 并 行 开 发 配置 Subversion 


安装 和 配置 SVN 服务 器 并 不 在 本 文 的 讨论 范围 之 内 。 如 果 您 有 权限 访问 一 个 有 效 的 SVN JR 
务 器 ， 就 可 以 执行 以 下 的 步骤 了 : 


将 SVN 客户 机 软件 下 载 到 您 的 工作 站 。 
在 工作 站 中 创建 一 个 标准 本 地 目录 。 
将 目录 添加 到 SVN 储存 库 。 

将 目录 提交 到 SVN 储存 库 。 


入 D> 


从 Tigris.org Web 站 点 (参见 参考 资料 ) 为 您 的 操作 系统 下 载 SVN 客户 机 软件 ， 并 将 其 安装 
到 您 的 工作 站 。 确 保 SVN 可 执行 文件 在 您 的 工作 站 的 系统 目录 中 。 用 svn co ur 执行 储 
存 库 的 SVN 签 出 。 


接 下 来 ， 创 建 三 个 本 地 目录 : 


e 分 支 : 用 于 维护 干线 开发 之 外 的 软件 。 
o 标记 : 在 发 布 软件 时 用 于 标识 变更 集 ， 以 备 使 用 。 
e 主干 : 用 于 干线 开发 。 


清单 1 展示 了 在 Windows® ` Macintosh 以 及 基于 *nix 的 系统 上 如 何 从 命令 行 创建 这 


录 : 
清单 1. 创建 本 地 目录 ， 将 其 添加 到 Subversion 


$ mkdir branches 
$ mkdir tags 
$ mkdir trunk 


D: 
n 


在 操作 系统 中 创建 了 目录 之 后 ， 您 可 以 分 别 使 用 SVN add 和 comit 命令 将 它们 添加 并 提 


交 到 SVN。 在 我 创建 清单 1 的 目录 的 目录 中 ， 我 输入 了 如 清单 2 所 示 的 命令 (在 适 
替代 用 户 赁 证 ) 


清单 2. 将 本 地 目录 添加 并 提交 到 远程 SVN 储存 库 


$ svn add *.* 


当 的 时 候 


$ svn commit -m "Setting up standard SVN branches, tags and trunk directories" \ 


--username tjefferson --password Mont!cello 


执行 了 清单 1 和 清单 2 中 的 操作 之 后 ，SVN 储存 库 应 该 类 似 于 图 2 : 


图 2. 在 储存 库 中 创建 的 标准 SVN 目录 





File Extension Revision Author Size Date 

-= E E E A 
* © branches 1 9/14/2007 8:05:20 PM 
* © tags 1 9/14/2007 8:05:20 PM 
2 gpunk oM 3 HB phu... s 9/4/2008 9:99:29 AM — 


基本 的 SVN 储存 库 就 绪 以 后 ， 就 可 以 创建 版 本 标记 了 。 


根据 主干 创建 一 个 版 本 标记 


标记 的 用 途 是 在 菜 个 特定 点 及 时 标识 代码 支线 副本 ， 以 便 以 后 返回 到 该 版 本 。 图 3 展示 了 一 
个 名 为 brewery-1.0.0 的 标记 ， 它 是 针对 1.0.0 版 本 创建 的 。 (标记 能 够 随时 在 任何 点 创 


建 ， 但 通常 都 是 在 发 布 软件 时 创建 ) 。 


图 3. 为 SVN 主干 创建 一 个 惟一 的 标记 


Trunk 


Y 


Brewery-1.0.0 


假设 主干 包含 已 发 布 的 软件 的 源 代码 的 话 ， 第 一 个 任务 就 是 要 依据 主干 创建 一 个 SVN 标记 。 
清单 3 就 是 一 个 关于 如 何 创 建 这 个 标记 的 例子 : 


清单 3. 根据 主干 创建 一 个 版 本 标记 


«path id-"svn.classpath"» 
«fileset dir-"$[lib.dirj"» 
«include namez"**/*,jar" /> 
«/fileset» 
«/path» 
«taskdef name-z"svn" classpathref-"svn.classpath" 
classname-"org.tigris.subversion.svnant.SvnTask"/» 


«target name-z"create-tag-from-trunk"» 
«svn username-"jhancock" password-"S!gnhere'» 
«copy srcUrl-"https://brewery-ci.googlecode.com/svn/trunk" 
destUrl-"https://brewery-ci.googlecode.com/svn/tags/brewery-1.0.0" 
message-"Tag created by jhancock on $(TODAYj" /> 


«/svn» 
«/target» 
安全 验证 失败 


zi 


Il 
ws 


第 一 次 运行 使 用 Hypertext Transfer Protocol 而 不 是 Secure Socket Layer 的 SVN 服 
时 ， 一 定 要 接受 安全 认证 。 如 果 您 是 第 一 次 这 样 从 Ant 脚本 连接 到 安全 SVN 服务 器 ， 连 接 会 
失败 ， 并 且 不 提供 诊断 信息 。 因 此 ， 第 一 次 时 ， 必 须 从 命令 行 运 行 SVN 命令 连接 到 服务 

以 后 ， 您 就 可 以 从 您 的 工作 站 运行 任何 SVN Ant 脚本 ， 以 连接 到 该 服务 器 。 


清单 3 使 用 了 由 Subclipse 开源 项 目 提供 的 SVN Ant 任务 (下 载 地 址 请 参见 参考 资料 ) 。 运 
行 该 Ant 脚本 时 ， 一 定 要 将 随 SVN Ant 任务 一 起 提供 的 JARs —svnant jar ^ 
svnClientAdapter.jar 和 svnjavahl.jar— 包含 在 您 的 类 路 径 中 。 清 单 3 的 前 半 部 分 定义 了 这 个 
类 路 径 。 中 间 部 分 使 用 taskdef 定义 了 SVN Ant 任务 。 最 后 ， 我 向 主干 和 标记 目录 执行 了 
SVN copy 命令 ， 从 而 为 这 个 版 本 提供 一 个 惟一 的 名 称 : brewery-1.0.0 . 


运行 清单 3 中 的 脚本 并 创建 了 一 个 新 标记 之 后 ， 您 的 SVN 储存 库 应 该 如 图 4 所 示 。 储 存 库 的 
根 级 下 面 是 标记 目录 (在 清单 2 中 创建 ) 。 而 标记 目录 的 下 面 是 在 清单 3 中 创建 的 新 标记 
(Hx) : brewery-1.0.0。 它 含有 主干 的 副本 。 


图 4. 根据 主干 创建 标记 


File Extension Revision Author Size Date 
= © https:/fbrewery-ci.googlecode.com/svn 





C3 branches 1 9/14/2007 8:05:20 PM 
3 ( tags 73 pduval 9/6/2008 8:48:50 PI 
Oi ma brewery-1.0.0 73 pduve 9/6/2008 8:48:50 PM 

= (C config 71 pduvall 6/10/2008 3:26:30 AM 

E © database 65 pduval 4/16/2008 2:16:03 PM 
e 加 docs 72 pduval 9/4/2008 9:59:23 AM 

由 (c3 instaler 21 pduval 11/14/2007 11:21:2... 

& (sre 69 pduval 4/28/2008 5:15:31 PM 

E © tests 55 pduval 4/15/2008 9:06:43 PM 

B) .comrmon:configuration.xml xmi 71 pduval 4KB 6/10/2008 3:26:30 AM 

la) .comeon-environment., ml xmi 2 pduval 1KB 9/14/2007 8:19:56 PM 

[&) _dbunit-seed.xml xmi 2 pduval 1K6 9/14/2007 8:19:56 PM 

[f] README.TXT TXT 2 pduval 2X8 9/14/2007 8:19:56 PM 

[&) | reposkory.xml xml 71 pduval 7K& éj10/2008 3:26:30 AM 


虽然 标记 的 内 容 在 Subversion 中 是 可 以 更 改 的 ， 但 千 万 不 要 这 样 做 。 


根据 版 本 标记 创建 一 个 分 支 


在 技术 上 ， 根 据 版 本 标记 创建 分 支 与 根据 主干 创建 标记 是 相似 的 。 两 者 都 要 使 用 到 SVN 的 
copy 命令 。 通 常 都 会 依照 标记 而 创建 分 支 ， 因 为 标记 的 是 已 发 布 的 代码 的 代码 副本 一 而 不 
是 正在 开发 的 代码 (可 能 已 经 更 改 ) 。 图 5 展示 了 如 何 根据 1.0.0 版 本 标记 创建 1.0.1 分 
X: 


版 本 命名 


人 们 一 直 都 想 找 到 一 个 简单 的 版 本 命名 的 模式 。 但 是 ， 只 要 一 个 版 本 和 下 一 个 版 本 或 不 同 项 

目 之 间 所 使 用 的 版 本 命名 模式 稍 有 不 同 的 话 ， 麻 烦 就 大 了 。 版 本 模式 可 能 有 很 多 种 。 一 定 要 

选择 一 个 既 简 单 又 能 够 灵活 处 理 将 来 的 版 本 的 模式 。 我 所 使 用 的 模式 是 major-version.minor- 
version.patch， 它 很 简单 。Version 1.1.2 就 是 以 这 个 命名 模式 命名 的 。 也 有 些 团队 选择 向 版 

本 追加 一 个 构建 号 。 


图 5. 根据 1.0.0 版 本 标记 创建 分 支 1.0.1 


1.1.0 





1.0.1 branch from 1.0.0 tag 


清单 4 通过 SVN Ant 任务 调用 了 SVN copy 命令 ， 以 将 brewery-1.0.0 标记 中 的 所 有 文件 
拷贝 到 分 支 位 置 : 


清单 4. 从 版 本 标记 创建 分 支 的 Ant 脚本 


«target name="create-branch-from-tag"> 
«svn username="sadams" password="bOstonM@ss"> 
«copy srcUrl-"https://brewery-ci.googlecode.com/svn/tags/brewery-1.0.0" 
destUrl-"https://brewery-ci.googlecode.com/svn/branches/brewery-1.0.1" 
message-"Branch created by sadams on $(TODAY)" /> 
«/svn» 
«/target» 


运行 清单 4 中 的 脚本 之 后 ，SVN 储存 库 应 该 如 图 6 所 示 : 


图 6. 从 版 本 标记 创建 分 支 








File Extension Revision Author Size Date 
=) [D hitps:ffbrewery-ci.googlecode.comjsvn 
- © branches 74 pduvall 9/6/2008 9:07:32 PM 
EE fie brewery-1.0.1 h Al 9/6/2008 9:07:32 PM 
* O config 71 pduvall 6/10/2008 3:26:30 AM 
*| E database 65 pduvall 4/16/2008 2:16:03 PM 
+ BB docs 72 pduvall 9/4/2008 9:59:23 AM 
* © installer 21 pduvall 11/14/2007 11:21:2... 
* (sc 69 pduvall 4/28/2008 5:15:31 PM 
*| E tests 55 pduvall 4/15/2008 9:06:43 PM 
e) _common-configuration. xml xml 71 pduvall 4KB 6/10/2008 3:26:30 AM 


记 住 主 于 


有 些 团队 处 理 分 支 开发 时 很 极端 ， 他 们 所 有 的 开发 工作 都 从 分 支 开始 。 要 记 住 ， 根 据 主干 进 
行 开发 会 更 轻松 、 更 易于 管理 。 分 支 就 是 为 了 并 行 地 进行 分 开 的 开发 。 尽 量 不 要 滥用 分 支 ， 
动不动 就 创建 分 支 。 


在 创建 分 支 和 使 用 SVN Ant 任务 时 ， 一 定 要 记得 使 用 标记 ， 这 样 您 才能 够 提供 一 个 可 重复 的 
过 程 ， 该 过 程 方便 源 代 码 的 维护 ， 使 您 可 以 轻松 返回 到 上 一 版 本 的 源 代码 。 
根据 分 支 运行 CI 


通常 CI 过 程 都 是 根据 储存 库 的 干线 〈 即 主干 ) 而 运行 的 。 但 如 果 想 集成 开发 人 员 在 分 支 上 的 
变更 并 检查 支线 与 干线 的 合并 ， 这 个 原理 也 适用 于 分 支 。 


图 7 展示 了 SVN 的 位 置 。 在 这 个 Hudson 配置 页 面 上 ， 您 还 能 够 定义 要 调用 的 Ant 目标 。 


图 7.Hudson Cl 服务 器 根据 主干 构建 分 支 并 测试 合并 


让 开发 自动 化 系列 专栏 


cry Config [Hudson] - Mozilla firefo 
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i&fT Hudson 等 CI 服务 器 来 测试 合并 可 以 提供 一 个 预警 系统 ， 警 告 可 能 会 在 开发 周期 中 发 生 
潜在 的 合并 冲突 。 


将 分 支 的 变更 合并 到 主干 


创建 分 支 的 主要 原因 之 一 就 是 防止 中 断 干线 开发 。 但 是 ， 一 定 要 将 分 支 上 的 更 改 合并 到 主 
干 。 图 8 展示 了 将 版 本 1.0.1 合并 到 干线 ， 这 个 干线 是 软件 正在 开发 的 版 本 1.1.0 : 


图 8. SVN 时 间 线 










Brewery-1.0.0 





1.0.0 (Release) 


1.1.0 (Release) 


在 清单 5 中 ， 我 使 用 了 Subversion 的 merge 命令 。 我 先 输入 svn merge. ， 接 着 是 合并 到 的 
目标 URL， 然后 是 合并 源 的 URL， 最 后 是 本 地 目录 位 置 : 


清单 5. 使 用 SVN 的 merge 命令 将 分 支 开 发 合并 到 主干 


让 开发 自动 化 : 针对 广大 开发 人 员 的 并 行 开发 37 


$ svn merge https://brewery-ci.googlecode.com/svn/trunk \ 
https://brewery-ci.googlecode.com/svn/branches/brewery-1.0.1 \ 
/dev/brewery --username pduvall --password password! 


SVN Ant 任务 没有 提供 合并 命令 ， 因 此 需要 从 命令 行 运行 merge 命令 。 或 者 使 用 Ant 的 
exec 任务 来 运行 它 。 


运行 清单 5 中 的 命令 会 得 到 类 似 于 图 9 的 结果 : 


图 9. 将 分 支 合并 到 主干 的 结果 





如 果 合 并 成 功 ， 则 需要 提交 Subversion 中 的 变更 ， 如 清单 6 所 示 。 在 命令 行 上 输入 
svn commit ， 然 后 输入 消息 描述 和 主干 的 SVN URL : 


清单 6. 将 合并 后 的 变更 提交 到 主干 


«target name="commit-branch-to-trunk"> 
«svn username="gwbush" password="ILOveTHEGOOg!e"> 
<commit dir="${basedir}" 
message="Committing changes from brewery-1.0.1"> 
</commit> 
</svn> 
</target> 


要 经 常 将 变更 从 分 支 合 并 到 主干 以 避免 合并 冲突 ， 从 而 使 代码 支线 始终 保持 一 致 。 


根据 分 支 创建 标记 


为 了 根据 特定 的 分 支 准备 一 个 版 本 ， 我 创建 了 一 个 SVN 标记 。 这 里 使 用 方法 与 前 面 一 些 清单 
提供 的 方法 类 似 。 图 10 展示 了 根据 brewery-1.0.1 分 支 创建 名 为 brewery-1.0.1 的 标记 的 
方法 : 


图 10. 根据 分 支 创建 标记 


Tag 
a Brewery-1.0.1 





1.0.0 1.1.0 
Trunk 


在 特定 的 分 支 上 完成 开发 后 ， 就 需要 在 Subversion 中 标记 它 。 清 单 7 展示 了 一 个 根据 分 支 创 
建 标 记 的 例子 : 


清单 7. 根据 分 支 创 建 SVN 标记 


«svn username="jbartlett" password="newHampsh!re"> 
<copy srcUrl="https://brewery-ci.googlecode.com/svn/branches/brewery-1.0.1" 
destUrl-"https://brewery-ci.googlecode.com/svn/tags/brewery-1.0.1" 
message-"Branch created by jbartlett on ${TODAY}" /> 
«/svn» 


根据 具体 分 支 创建 标记 之 后 ， 您 就 可 以 在 以 后 的 开发 周期 中 返回 到 该 版 本 了 。 


结束 语 


并 行 开发 并 不 是 什么 难事 ， 但 如 果 不 按照 项 目 需求 进行 规划 并 不 断 改进 ， 它 的 管理 将 非常 困 
难 。 如 果 必 须 记 住 一 点 的 话 ， 那 就 是 一 切 最 终 都 要 回 到 主干 。 您 可 以 将 分 支 看 作 是 一 个 容纳 
可 能 中 断 干 线 开 发 的 源 代码 的 临时 居所 。 最 后 要 考虑 的 是 要 尽早 地 、 经 常 地 测试 合并 。 当 然 
可 能 有 比 Subversion 更 好 的 支持 并 行 开发 的 版 本 控制 系统 ， 但 根据 我 的 经 验 ， 开 发 团队 在 开 
发 时 坚持 原则 比 使 用 工具 解决 问题 重要 得 多 。 


让 开发 自动 化 : 实现 自动 化 数据 库 迁 移 


使 用 LiquiBase 管理 数据 库 变更 


数据 库 通常 不 能 够 与 它们 支持 的 应 用 程序 保持 同步 ， 从 管理 方面 来 讲 ， 将 数据 库 和 数据 置 于 
一 个 已 知 状态 是 个 很 大 的 挑战 。 在 本 期 的 让 开发 自动 化 中 ， 自 动 化 专家 Paul Duvall 演示 了 如 
何 使 用 开源 的 LiquiBase 数据 库 迁 移 工具 轻松 地 处 理 数据 库 和 应 用 程序 的 频繁 变更 。 


在 过 去 几 年 中 ， 我 使 用 过 的 大 多 数 应 用 程序 都 是 需要 管理 大 量 数据 的 企业 应 用 程序 。 从 事 这 
类 项 目的 开发 团队 常常 将 数据 库 视 为 与 应 用 程序 完全 脱离 的 单独 实体 。 造 成 这 种 现象 的 原因 
是 组 织 结构 经 常 将 数据 库 团 队 从 应 用 程序 开发 团队 分 离 出 来 。 有 时 候 ， 这 是 团队 的 习惯 引起 
的 。 不 管 怎样 ， 我 发 现 这 种 分 离 会 导致 (或 忽略 ) 一 些 实践 : 


e 手工 变更 数据 库 

e 不 能 与 团队 的 其 他 成 员 分 享 数据 库 变更 

e 使 用 不 一 致 的 方法 变更 数据 库 或 数据 

o 使 用 低 效 的 手工 方法 管理 数据 库 版 本 之 间 的 变更 


这 些 实践 效率 低下 ， 使 开发 人 员 无 法 与 数据 变更 保持 同步 。 而 且 ， 还 使 应 用 程序 的 用 户 遇 到 
与 数据 不 一 致 和 数据 损坏 等 问题 。 


图 1 演示 了 软件 开发 项 目 中 经 常用 到 的 手工 方法 。 手 工 方法 在 使 用 时 通常 不 能 保证 一 致 性 并 
且 容 易 产生 错误 ， 撤 销 已 完成 的 工作 很 困难 ， 而 且 难 以 分 析 数据 库 变更 的 历史 。 例 如 ， 某 个 
DBA 可 能 想 变 更 查找 数据 ， 但 是 开发 人 员 却 忘记 将 这 个 数据 插入 到 同一 个 表 中 。 


关于 本 系列 


作为 开发 人 员 ， 我 们 致力 于 用 户 自动 化 流程 ; 但 许多 开发 人 员 却 足 忽 了 自动 化 自己 的 开发 流 
程 。 为 此 ， 我 们 编写 了 让 开发 自动 化 系列 文章 ， 专 门 探讨 软件 开发 流程 自动 化 的 实践 应 用 ， 
为 您 介绍 何 时 以 及 如 何 成 功 应 用 自动 化 。 


图 1. 手工 变更 数据 库 
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Developer 


通过 实现 最 小 化 人 为 干预 的 数据 库 ， 可 以 避免 手工 方法 带 来 的 缺陷 。 通 过 结合 各 种 
实践 和 工具 ， 可 以 使 用 一 致 且 可 重复 的 过 程 变更 数据 库 和 数据 。 在 本 文中 ， 我 将 介绍 以 下 内 
容 : 。 


e 使 用 一 种 称 为 LiquiBase 的 工具 在 各 个 数据 库 版 本 之 间 进 行 迁 移 
e 如 何 自 动 运行 数据 库 迁 移 

e 一 致 地 变更 数据 库 的 实践 

o 使 用 LiquiBase 进行 数据 库 重 构 


在 图 2 中 ， 一 个 Build/Continuous Integration 服务 器 轮 询 版 本 控制 库 (例如 子 版 本 ) 中 的 变 
更 。 当 它 发 现 一 个 变更 后 ， 将 运行 一 个 自动 化 构建 脚本 ， 该 脚本 使 用 LiquiBase 更 新 数据 
E. o 


图 2. 自动 化 数据 库 迁 移 
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通过 使 用 类 似 图 2 所 示 的 过 4 各， 加 愉 让 的 任何 人 者 可 以 将 相同 的 变更 应 用 到 数据 库 中 一 可 以 
是 本 地 或 共享 数据 库 服务 器 。 此 外 ， 由 于 这 个 过 程 使 用 了 自动 化 脚本 ， 因 此 这 些 变 更 不 需要 
任何 人 为 干预 就 可 以 应 用 到 不 同 环境 中 。 


DDL ` DML 模式 、 数 据 库 或 数据 


在 本 文中 ， 我 使 用 术语 数据 库 变更 表示 通过 应 用 数据 定义 语言 (Data Definition Language ， 
Po 脚本 变更 数据 库 结 构 。 (一 些 数据 库 供应 商 将 之 称 为 模式 ) 。 同 时 ， 我 将 通过 数据 定 
LE € (DML) 脚本 变更 数据 库 称 为 数据 变更 。 


使 用 LiquiBase 管理 数据 库 变 


LiquiBase (从 2006 年 开始 投入 使 用 ) 是 一 种 免费 开源 的 工具 ， 可 以 实现 不 同 数据 库 版 本 之 
间 的 迁移 (参见 参考 资料 ) 。 目 前 也 存在 少量 其 他 开源 数据 库 迁 移 工具 ， 包 括 openDBcopy 
和 dbdeploy。LiquiBase 支持 10 种 数据 库 类 型 ， 包 括 DB2 ^ Apache Derby ` MySQL ` 
PostgreSQL 、Oracle、 Microsoft®SQL Server ` Sybase 和 HSQL ° 


要 安装 LiquiBase， 下 载 经 过 压缩 的 LiquiBase Core 文件 ， 解 压缩 ， 然 后 将 包含 的 liquibase- 
version.jar 文件 放 到 系统 路 径 中 。 


要 开始 使 用 LiquiBase， 需 要 以 下 四 个 步骤 : 


创建 一 个 数据 库 变更 日 志 (changelog) 文件 。 

在 变更 日 志文 件 内 部 创建 一 个 变更 集 (change set) 。 
通过 命令 行 或 构建 脚本 对 数据 库 运行 变更 集 。 
检验 数据 库 中 的 变更 。 


om 


创建 一 个 变更 日 志和 变更 集 
要 运行 LiquiBase， 如 清单 1 所 示 ， 首 先 要 创建 一 个 XML 文件 ， 也 称 为 数据 库 变更 日 志 : 
清单 1. 在 LiquiBase XML 文件 中 定义 一 个 变更 集 


<?xml versionz"1.0" encoding-"UTF-8"?» 


«databaseChangeLogxmlns-"http://www.liquibase.org/xml/ns/dbchangelog/1.7" 
xmlns:xsi-'"http://www.w3.0rg/2001/XMLSchema- instance" 
xsi:schemaLocation-z"http://www.liquibase.org/xml/ns/dbchangelog/1.7 

http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-1.7.xsd"» 
«changeSetid-z"2" authorz"paul"» 
«createTable tableName-"brewer"- 
«column name="id" type="int"> 
«constraints primaryKey-"true" nullable-"false"/» 
«/column» 
«column name="name" typez'varchar(255)'"» 
«constraints nullable-"false"/» 
«/column» 
«column name-z"active" type-"boolean" defaultValuez"1"/» 
«/createTable» 
«/changeSet» 
«/databaseChangeLog» 


再 次 使 用 XML 


有 些 开 发 人 员 会 使 用 XML， 而 其 他 人 则 没有 涉足 这 个 领域 。 很 多 开发 人 员 甚 至 已 经 习惯 使 用 

XML 脚本 进行 编程 (例如 ， 使 用 Apache Ant). ， 但 是 DBA 不 一 定 用 到 。 有 最近， 我 非常 兴 
地 向 一 个 DBA 同事 展示 LiquiBase 的 一 些 特性 。 他 非常 喜欢 其 中 一 些 强大 的 数据 库 变 更 管理 
工具 ， 但 是 很 怀疑 DBA 是 否 会 使 用 基于 XML 的 语法 。 我 向 他 保证 ，LiquiBase 还 通过 它 的 
sqlFile 和 sql 定制 重 构 支 持 调 用 定制 SQL 脚本 。 


可 以 看 到 ， 数 据 库 变更 日 志文 件 包 括 一 个 XML 模式 引用 〈LiquiBase 安装 中 包含 的 
dbchangelog-1.7.xsd 文件 ) 。 我 在 变更 日 志文 件 中 创建 了 一 个 &lt;changeset&gt; 。 在 
&lt;changeSet&gt; 中 ， 我 使 用 结构 化 的 方式 将 变更 应 用 到 数据 库 ， 如 LiquiBase 模式 所 定 


liquibase --driver-org.apache.derby.jdbc.EmbeddedDriver \ 
--classpath-derby.jar \ 
--changeLogFile-database.changelog.xmlN 
--url-jdbc:derby:brewery;create-true \ 

--username- --password- \ 

update 


在 本 例 中 ， 运 行 LiquiBase 传 入 的 内 容 : 


e 数据 库 驱 动 器 

数据 库 驱 动 器 JAR 文件 的 位 置 所 在 的 类 路 径 

所 创建 的 变更 日 志文 件 (如 清单 1 所 示 ) 名 称 为 database.changelog.xml 
数据 库 的 URL 

用 户 名 和 密码 


最 后 ， 清 单 2 调用 update 命令 告诉 LiquiBase 将 变更 应 用 到 数据 库 中 。 


在 自动 构建 中 运行 LiquiBase 


这 里 并 不 使 用 命令 行 选项 ， 通 过 调用 LiquiBase 提供 的 Ant 任务 ， 可 以 将 数据 库 变更 作为 自 
动 化 构建 的 一 部 分 。 清 单 3 展示 了 Ant 任务 的 示例 : 


清单 3. 执行 updatepatabase Ant 任务 的 Ant 脚本 


«target name="update-database"> 
«taskdef name-"updateDatabase" classname-"liquibase.ant.DatabaseUpdateTask" 
classpathref-z"project.class.path" /> 
«updateDatabase changeLogFile-"database.changelog.xml" 
driver-"org.apache.derby.jdbc.EmbeddedDriver" 
url-z"jdbc:derby:brewery" 
usernamez"" 
passwordz"" 
dropFirst-"true" 
classpathrefz"project.class.path"/» 
</target> 


在 清单 3 中 * 创建 了 一 个 名 为 update-database 的 目标 。 在 其 中 定义 了 一 个 将 要 用 到 的 特殊 
LiquiBase Ant 任务 ， 称 为 updateDatabase 。 我 传 入 需要 的 值 ， 包括 changeLogFile (指定 
清单 1 中 定义 的 变更 日 志文 件 ) 和 数据 库 的 连接 信息 。 classpathref 中 定义 的 类 路 径 必 须 包 
4 liquibase-version.jar ° 


运行 前 后 
图 3 展示 了 在 清单 1 中 运行 变更 集 之 前 的 数据 库 状态 : 


图 3. 运行 LiquiBase 变更 集 之 前 的 数据 库 状 态 


C] root&localhost 
a E brewery 
:EE 
€ 
state 
由 E user 
由 E Views 
四 [F7] Stored Procs 
由 E Functions 
四 [F7] Triggers 








图 4 展示 了 运行 数据 库 变 更 集 的 结果 ， 可 以 通过 命令 行 (如 清单 2 所 示 ) 或 从 Ant (如 清单 
3 所 示 ) 运行 


图 4. 运行 LiquiBase 变更 集 后 将 变更 应 用 到 数据 库 


EE iret O mespes ID oa Tobie Osta |A icbc ore 
4 |s | 





两 天 机 下 机 下 再 下 这 


查看 完整 的 图 。 


需要 注意 图 4 中 的 几 个 方面 。 创 建 了 两 个 特定 于 LiquiBase 的 表 ， 以 及 一 个 根据 清单 1 中 的 

变更 集 定义 创建 的 新 表 。 第 一 个 特定 于 LiquiBase 的 表 称 为 databasechangelog ， 它 跟 踪 应 用 
到 数据 库 的 所 有 变更 一 有 助 于 跟踪 谁 执行 了 数据 库 变更 以 及 原因 。 第 二 个 特定 于 LiquiBase- 
的 表 是 databasechangelock ， 标 识 出 具有 数据 库 变 更 锁 的 用 户 。 


还 可 以 使 用 多 种 其 他 方式 运行 LiquiBase， 但 我 已 经 介绍 了 应 用 数据 库 变更 所 需 的 大 部 分 信 
息 。 在 使 用 LiquiBase 时 ， 将 花 很 多 时 间 研 究 应 用 数据 库 重 构 的 各 种 方法 ， 以 及 变更 特定 数 
据 库 的 复杂 性 。 例 如 ，LiquiBase 提供 了 数据 回 滚 支持 ， 这 可 能 是 个 很 大 的 挑战 。 在 展示 数据 
库 重 构 示例 之 前 ， 我 将 快速 浏览 一 些 数据 库 集成 的 基本 原则 和 实践 ， 它 们 能 帮助 您 充分 利用 
数据 库 迁 移 


项 繁 集成 数据 库 变 


最 近 几 年 ， 开 发 团队 将 类 似 于 处 理 源 代码 的 原则 和 实践 应 用 到 数据 库 资产 管理 中 。 因 此 ， 可 
以 将 数据 库 变更 编写 为 脚本 、 在 一 个 源 代码 库 中 共享 这 些 资产 ， 以 及 将 变更 集成 到 构建 和 持 
续集 成 过 程 ， 这 只 是 自然 的 演进 。 表 1 概括 了 开发 团队 将 数据 库 变更 变 成 一 个 自动 化 过 程 的 


一 部 分 时 ， 需 要 遵循 的 关键 实践 : 


自动 化 DBA 


在 我 曾经 参与 的 一 些 项 目 中 ，DBA 在 控制 开发 数据 库 的 变更 时 造成 了 一 些 不 必要 的 瓶颈 。 
DBA 应 该 把 时 间 花 在 一 些 创新 的 、 非 重复 性 行为 ， 例 如 监视 和 改善 数据 库 性 能 ， 而 不 是 假借 
控制 性 和 一 致 性 的 名 义 做 一 些 无 用 的 重复 性 工作 。 


表 1. 数据 库 集成 实践 


实践 说 明 
脚本 化 所 有 DDL 和 DML 数据 库 变更 应 该 能 够 从 命令 行 运行 。 
数据 资产 的 源 代 码 控制 使 用 一 个 版 本 控制 库 管 理 所 有 与 数据 库 相 关 的 变更 。 
本 地 数据 库 沙 盒 每 个 开发 人 员 使 用 一 个 本 地 数据 库 沙 盒 执行 变更 。 
自动 化 数据 库 集成 将 数据 库 相 关 的 变更 作为 构建 过 程 的 一 部 分 。 


些 实践 确保 了 更 好 的 一 致 性 并 防止 变更 在 软件 版 本 转换 之 间 丢 失 。 


对 现 有 数据 库 应 用 重 构 


随 着 新 特性 添加 到 了 应 用 程序 中 ， 经 常 需要 变更 数据 库 的 结构 或 修改 表 约 束 。LiquiBase 提 了 
超过 30 种 数据 库 重 构 支 持 (参见 参考 资料 ) 。 本 节 将 介绍 A 种 重 构 : 添加 列 (Add 
Column) 、 删 除 列 (Drop Column) 、 创 建 表 (Create Table) 和 操作 数据 。 


添加 列 


在 项 目的 开始 ， 几乎 不 可 能 考虑 到 数据 库 中 的 所 有 列 。 而 有 时 候 ， 用 户 要 求 新 的 特性 一 例如 
为 存储 在 系统 中 的 信息 收集 更 多 的 数据 一 这 就 要 求 添加 新 的 列 。 清 单 4 使 用 LiquiBase 
addcolum 重 构 ， 向 数据 库 中 的 distributor 表 添 加 了 一 个 列 : 


清单 4. 使 用 LiquiBase 变更 集中 的 Add Column 数据 库 重 构 


«changeSet id-"4" authorz"joe"- 
«addColumn tableName-"distributor"- 
«column name-"phonenumber" type-'"varchar(255)"/» 
«/addColumn» 
«/changeSet» 


新 的 phonenumber 列 被 定义 为 varchar 数据 类 型 。 


删除 列 


假如 在 以 后 几 个 版 本 中 ， 您 想 要 删除 在 清单 4 添加 的 phonenumber 列 。 只 需要 调用 
dropcolumn 重 构 ， 如 清单 5 所 示 : 


清单 5. 删除 一 个 数据 库 列 


«dropColumn tableName="distributor" columnName="phonenumber"/> 


创建 表 


向 数据 库 添 加 一 个 新 表 也 是 常 见 的 数据 库 重 构 9 清单 6 创建 了 一 个 新 表 distributor ^? 定义 
了 列 、 约 束 和 默认 值 : 


清单 6. 在 LiquiBase 中 创建 一 个 新 数据 库 表 


«changeSet id-"3" author="betsey"> 
«createTable tableName-"distributor"» 
«column name="id" type="int"> 
<constraints primaryKey="true" nullable="false"/> 
</column> 
<column name="name" type="varchar(255)"> 
<constraints nullable="false"/> 
</column> 
«column name="address" type="varchar(255)"> 
<constraints nullable="true"/> 
</column> 
«column name="active" type="boolean" defaultValuez"1"/» 
</createTable> 
«/changeSet» 


这 个 示例 使 用 了 createTable 数据 库 重 构 作 为 变更 集 的 一 部 分 (清单 1 中 也 使 用 了 


createTable ) 9 


操作 数据 


在 应 用 了 结构 性 数据 重 构 后 (例如 添加 列 和 创建 表 ) ， 通 常 需要 向 受 重 构 影 响 的 表 中 插入 数 
据 。 此 外 ， 可 能 需要 修改 查找 表 (或 其 他 类 型 的 表 ) 中 的 现 有 数据 。 清 单 7 展示 了 如 何 使 用 
一 个 LiquiBase 变更 集 播 入 数据 : 


清单 7. 使 用 一 个 LiquiBase 变更 集 插入 数据 


«changeSet id="3" author="betsey"> 
«code type="section" width="100%"> 
<insert tableName="distributor"> 
«column name="id" valueNumeric="3"/> 
«column name="name" value="Manassas Beer Company"/» 
«/insert» 
«insert tableName-"distributor'» 
«column name="id" valueNumericz'4"/» 
«column name="name" value-"Harrisonburg Beer Distributors"/» 
«/insert» 
«/changeSet» 


您 应 该 编写 用 于 操作 数据 的 SQL 脚本 ， 因 为 使 用 LiquiBase XML 变更 集 限制 很 多 。 有 时 候 使 
用 SQL 脚本 向 数据 库 应 用 大 量 的 变更 会 简单 一 些 。LiquiBase 也 可 以 支持 这 些 情 景 。 清 单 8 
调用 变更 集中 的 insert-distributor-data.sql 来 插入 distributor 表 数 据 : 


清单 8. 从 LiquiBase 变更 集运 行 一 个 定制 SQL x fF 


«changeSet id="6" author="joe"> 
«sglFile path-z"insert-distributor-data.sql"/» 
«/changeSet» 


LiquiBase 支持 很 多 其 他 数据 库 重 构 ， 包 括 Add Lookup Table 和 Merge Columns ° T VA4£ A 
如 清单 4 到 清单 8 所 示 的 方式 定义 所 有 这 些 支持 。 


持续 保持 数据 同步 


在 软件 开发 中 ， 如 果 遇 到 一 些 难题 ， 您 应 该 更 多 地 关注 它 ， 而 不 是 等 到 以 后 dis 
操作 ， 从 而 使 问题 变 得 更 严重 ， 花 费 也 更 大 。 数 据 库 迁移 非常 重要 ， 自 动 化 迁移 过 程 能 够 获 
得 很 多 好 处 。 在 本 文中 ， 我 已 经 介绍 了 以 下 内 容 : 


。 演示 如 何 使 用 LiquiBase 脚本 化 数据 库 迁 移 并 将 这 些 变 更 变 成 自动 化 构建 过 程 的 一 部 分 

e 描述 了 实现 一 致 性 的 数据 库 集 成 的 原则 和 实践 

e 展示 如 何 通过 使 用 LiquiBase 应 用 数据 库 重 构 ， 比 如 Add Column ` Create Table 和 更 新 
数据 


表 2 总 结 了 LiquiBase 提供 的 一 些 特 性 的 列表 : 


表 2. LiquiBase 部 分 特性 


特性 说 明 


支持 DB2 ^ Apache Derby ` MySQL ` PostgreSQL ` Oracle ` 
Microsoft SQL Server ` Sybase fe HSQL 等 。 


查看 应 用 到 数据 库 使 用 databasechangelog 表 ， 可 以 查看 应 用 到 数据 库 的 每 一 个 变 
的 变更 的 历史 。 


支持 多 个 数据 库 


3 H 1 f& LiquiBase 变更 集 以 外 的 应 用 到 数据 库 的 变更 。 


abb ah AT È H 
p ÆA SQL — 使 用 LiquiBase 调用 已 经 编写 好 的 SQL 脚本 。 


ple 可 以 对 应 用 到 数据 库 的 任何 变更 执行 回 滚 。 


可 以 看 到 ， 通 过 自动 化 脚本 恰当 地 应 用 变更 时 ， 数 据 库 迁 移 变 得 更 加 轻松 ， 并 且 成 为 团队 中 
的 多 数 成 员 都 可 以 运行 的 重复 过 程 。 


让 开发 自动 化 : 持续 重 构 


使 用 静态 分 析 工 具 识 别 代 码 味道 


重 构 是 公认 的 改进 现 有 代码 的 好 方法 。 然 而 ， 如 何 通 过 一 种 一 致 且 可 重复 的 方式 找到 需要 重 
构 的 代码 呢 ? 本 期 的 让 开发 自动 化 阐述 了 如 何 使 用 静态 分 析 工 具 来 识别 需要 重 构 的 代码 味 
道 ， 并 举例 说 明了 如 何 改进 坏 味道 代码 。 


在 过 去 的 几 年 里 ， 我 曾 看 过 很 多 项 目的 大 量 源 代码 ， 从 精美 的 设计 到 像 是 用 胶带 绑 定 到 一 起 
的 代码 。 我 写 过 新 的 代码 也 维护 过 其 他 开发 人 员 的 源 代 码 。 我 喜欢 编写 新 的 代码 ， 但 也 喜欢 
采用 一 些 现 有 的 代码 ， 以 某 种 方法 将 其 简化 或 将 重复 的 代码 提取 到 一 个 公共 类 中 。 在 我 早期 
的 工作 生涯 中 ， 许 多 人 都 认为 如 果 不 编写 新 的 代码 就 不 会 有 好 的 效率 。 幸 好 ， 在 20 世纪 90 
年 代 末 ，Martin Fowler 编写 了 Refactoring 一 书 (参见 参考 资料 ) ， 它 使 得 在 不 改变 外 部 行 
为 的 前 提 下 改进 现 有 代码 成 为 可 能 。 


我 在 本 系列 中 所 一 直 推 党 的 就 是 效率 : 如 何 减 少 耗 时 过 程 的 宛 余 度 ， 更 快速 地 执行 它们 。 在 
本 文 的 任务 中 ， 我 一 样 推崇 这 个 目标 ， 并 且 将 论述 怎样 更 有 效 地 执行 它们 。 


关于 本 系列 


作为 开发 人 人员， 我 们 致力 于 为 用 户 自动 化 流程 ; 但 许多 开发 人 员 叭 忽 了 自动 化 我 们 自己 的 开 
发 流程 的 机 会 。 为 此 ， 我 们 编写 了 让 开发 自动 化 系列 文章 ， 专 门 探讨 软件 开发 流程 自动 化 的 
实践 应 用 ， 为 您 介绍 何 时 以 及 如 何 成 功 应 用 自动 化 。 


重 构 的 一 个 典型 方法 是 在 引入 新 代码 或 更 改 方法 时 对 现 有 代码 做 出 小 小 的 变动 。 该 技巧 面临 
的 挑战 在 于 一 个 开发 团队 的 开发 人 员 的 应 用 方法 不 一 致 ， 并 且 很 容易 错失 重 构 的 机 会 。 这 也 
正 是 我 提倡 使 用 静态 分 析 工具 识别 编码 违规 的 原因 所 在 。 有 了 这 些 工 具 ， 您 就 能 够 从 总 体 上 
了 解 代 码 库 ， 并 且 处 于 类 或 方法 的 级 别 。 幸 运 的 是 ， 在 Java™ 程 序 设计 中 ， 您 可 以 选择 的 可 
免费 下 载 的 开源 静态 分 析 工 具 很 多 : CheckStyle、PMD、FindBugs、JavaNCSS、JDepend 


A XE 


等 等 。 
在 本 文中 ， 您 将 学 习 如 何 : 


e 使 用 CheckStyle 度量 E X 4&/£ (cyclomatic complexity) ， 并 提供 诸如 Replace 
Conditional with Polymorphism 之 类 的 重 构 ， 以 此 来 减少 条 件 复杂 度 代码 味道 

e 使 用 CheckStyle 评估 代码 重复 率 ， 并 提供 诸如 Pull Up Method 之 类 的 重 构 ， 以 此 来 移 
除 重复 代码 

e 使 用 PMD (或 JavaNCSS) 计算 源 代 码 行 ， 并 提供 诸如 Extract Method 之 类 的 重 构 ， 
以 此 来 淡化 大 类 代码 味道 

e 使 用 CheckStyle (或 JDepend) 确定 一 个 类 的 传 出 耦合 度 (efferent coupling) ， 并 
提供 诸如 Move Method 之 类 的 重 构 ， 以 此 来 除 掉 过 多 的 导入 代码 味道 


我 将 使 用 如 下 的 通用 格式 来 检查 每 一 种 代码 味道 : 


描述 可 以 指示 出 代码 里 面 的 问题 的 味道 

定义 可 以 找到 该 味道 的 度量 方法 

展示 可 以 度量 代码 味道 的 工具 

提供 用 于 修复 代码 味道 的 重 构 和 模式 (在 某 些 情况 下 ) 


DD 


实质 上 ， 这 个 方法 提供 了 一 个 找到 和 修复 整个 代码 库 中 的 代码 味道 的 一 个 框架 。 这 样 您 就 可 
以 更 好 地 了 解 到 代码 库 中 较 危 险 的 部 分 ， 然 后 再 做 出 更 改 。 更 好 的 是 ， 我 还 会 向 您 展示 如 何 
将 这 个 方法 集成 到 自动 构建 中 。 


您 的 代码 有 味道 么 ? 


所 谓 代码 味道 其 实 只 是 一 种 提示 ， 提 示 一 些 内容 可 能 存在 错误 。 和 模式 类 似 ， 代 码 味道 提供 
了 一 个 通用 词汇 表 ， 您 可 以 用 它 来 快速 识别 这 些 类 型 的 潜在 问题 。 在 文章 中 AUT ERE 
味道 是 很 有 难度 的 ， 因 为 它 可 能 包括 很 多 行 代码 ， 这 样 就 过 分 地 加 大 了 文章 的 篇 幅 。 因 此 ， 
我 会 只 针对 其 中 的 一 些 味道 进行 示范 ， 然 后 您 就 可 以 根据 查看 特定 代码 味道 的 经 验 进行 扒 

断 ， 识 别 出 剩 余 的 代码 味道 。 


条 件 复杂 度 

味道 : 条 件 复杂 度 

度量 : 圈 复 杂 度 

工具 : CheckStyle、JavaNCSS 以 及 PMD 


重 构 : Replace Conditional with Polymorphism ` Extract Method 


条 件 复 杂 度 可 以 以 几 种 不 同 的 方式 出 现在 源 代 码 中 。 这 种 代码 味道 的 一 个 例子 就 是 含有 多 个 
条 件 语句 ， 如 if ^ while 或 者 for 语句 。 另 一 种 条 件 复杂 度 是 以 switch i$ 6] 8970 XX X 3L 
出 来 的 ， 如 清单 1 所 示 : 


清单 1. 使 用 switch 语句 来 执行 条 件 行为 


switch (beerType) { 
case LAGER: 
System.out.println("Ingredients are..."); 


break; 
case BROWNALE: 
System.out.println("Ingredients are..."); 
break; 
case PORTER 
System.out.println("Ingredients are..."); 
break; 
case STOUT: 
System.out.println("Ingredients are..."); 
break; 
case PALELAGER: 
System.out.println("Ingredients are..."); 
break; 
default: 
System.out.println("INVALID."); 


break; 


switch 语句 本 身 并 没有 不 妥 。 但 当 一 个 语句 包含 太 多 的 选择 和 代码 时 ， 它 就 可 能 暗示 有 需要 
重 构 的 代码 。 

度量 

要 确定 条 件 复杂 度 代码 味道 ， 需 要 确定 方法 的 圈 复 杂 度 。 圈 复杂 度 是 一 种 度量 方法 ， 由 
Thomas McCabe 于 1975 年 定义 。 圈 复杂 度数 (Cyclomatic Complexity Number > CCN) € 
量 一 个 方法 中 茶 一 路 径 的 数量 。 无 论 一 个 方法 中 有 多 少 条 路 径 ， 它 的 起 始 CNN 都 从 1 开始 。 
每 一 个 条 件 构造 ， 如 if ^ switch ^ while 和 for 语句 ， 都 被 分 配 一 个 1 值 和 蜡 常 路 径 。 
一 个 方法 的 总 的 CCN 表明 了 它 的 复杂 度 。 很 多 人 认为 当 CCN 为 10 或 超过 10 时 ， 就 表明 该 
方法 过 于 复杂 。 


工具 


CheckStyle、JavaNCSS、 以 及 PMD 都 是 度量 圈 复 杂 度 的 开源 工具 。 清 单 2 展示 了 用 XML 
定义 的 CheckStyle 规则 文件 的 一 个 代码 片断 。 cyclomaticcomplexity 模块 定义 了 一 个 方法 的 
CCN 的 最 大 限度 。 


清单 2. 配置 CheckStyle， 查 找 圈 复杂 度 为 10 或 大 于 10 的 方法 


«module name-z"CyclomaticComplexity"» 
«property name-"max" Value="10"/> 
«/module» 


用 清单 2 的 CheckStyle 规则 文件 、 清 单 3 的 Gant 例子 来 示范 如 何 将 CheckStyle 作为 一 个 
自动 构建 的 一 部 分 来 运行 。 (参见 什么 是 Gant ? 侧 边 栏 ) 


清单 3. 使 用 Gant 脚本 来 执行 CheckStyle 检查 


target(findHighCcn:"Finds method with a high cyclomatic complexity number"){ 

Ant.mkdir(dir:"target/reports") 

Ant.taskdef(name:"checkstyle", 
classname:"com.puppycrawl.tools.checkstyle.CheckStyleTask", 
classpathref:"build.classpath") 

Ant.checkstyle(shortFilenames:" true", config:"config/checkstyle/cs checks.xml", 
failOnViolation:" false", failureProperty:"checks.failed", classpathref:"libdir") { 
formatter(type:"xml", tofile:"target/reports/checkstyle report.xml") 
formatter(type:"html", tofile:"target/reports/checkstyle report.html") 
fileset(dir:"src")( 

include(name:"**/*,java") 


} 
| 


什么 是 Gant ? 


Gant 是 一 个 自动 构建 工具 ， 它 提供 了 一 个 支持 构建 依赖 关系 的 表达 能 力 强 的 编程 语言 。 开 发 
人 员 利 用 Groovy 编程 语言 的 强大 功能 编写 Gant 脚本 。 由 于 Gant 提供 对 Ant 的 API 的 完全 
访问 ， 所 以 任何 可 以 运行 于 Ant 的 东西 都 可 以 从 Gant 脚本 运行 。 (参见 “用 Gant 构建 软件 ” 
教程 ， 了 解 Gant。) 


清单 3 中 的 Gant 脚本 创建 了 图 1 中 展示 的 CheckStyle 报告 。 该 图 下 面 的 部 分 指示 出 了 一 个 
方法 的 CheckStyle 圈 复 杂 度 违规 。 


图 1. CheckStyle 报告 根据 过 高 的 CCN 来 指示 一 种 方法 失败 


File C:\devibrewery-temp'src\com\beer\business\service\BeerServicelmpl.java 





Error Description 
Cyclomatic Complexity is 14 (max allowed is 10). 


Line contains a tab character. 


3 143 
图 2 为 用 UML 表示 的 Replace Conditional with Polymorphism € 3 : 


图 2. 用 多 态 蔡 代 条 件 语句 
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单 击 此 处 查看 完整 图 。 
在 图 2 中， 我 : 


1. 创建 了 一 个 叫做 BeerType 的 Java 界面 
2. 定义 了 一 个 通用 的 showrngredients() 方法 
3. 为 每 一 个 Beerrype 创建 了 一 个 实现 类 


为 了 使 文章 保持 简洁 ， 我 仅 为 每 一 个 类 提供 一 个 方法 的 实现 。 显 然 ， 创 建 一 个 界面 的 方法 可 
能 不 只 一 个 。 重 构 能 够 使 代码 更 易于 维护 ， 如 Replace Conditional with Polymorphism 和 
Extract Method (本 文 稍 后 将 会 讨论 ) 。 


重复 代码 
味道 : 重复 代码 
度量 : 代码 重复 率 

工具 : CheckStyle、PMD 


重 构 : Extract Method ` Pull Up Method ` Form Template Method ` Substitute Algorithm 


重复 代码 可 能 在 代码 库 中 悄然 发 生 。 有 了 时， 复制 粘贴 茶 些 代码 要 比 将 该 行为 泛 化 到 另 一 个 类 
更 简单 。 但 复制 粘贴 的 方法 存在 一 个 问题 ， 即 它 强制 将 代码 复制 多 份 ， 并 且 需 要 维护 。 而 且 
当 复 制 出 的 代码 发 生 轻 微 的 变化 而 引发 行为 不 一 致 时 ， 就 会 发 生 更 不 易 察 觉 的 问题 ， 具 体 取 
决 于 哪个 方法 在 执行 该 行为 。 清 单 4 是 一 个 关闭 代码 库 连 接 的 代码 示例 ， 相 同 的 代码 出 现在 
两 种 方法 中 : 


清单 4. 重复 代码 


public Collection findAllStates(String sql) { 


try { 
if (resultSet !- null) { 
resultSet.close(); 


} 
if (stmt != null) { 
stmt.close(); 


} 
if (conn !- null) { 
conn.close(); 


j 
catch (SQLException se) { 
throw new RuntimeException(se); 


} 
} 


} 
public int create(String sql, Beer beer) { 
try { 
if (resultSet != null) { 


resultSet.close(); 


} 
if (stmt !- null) { 
stmt.close(); 


} 
if (conn !- null) { 
conn.close(); 


} 
catch (SQLException se) { 
throw new RuntimeException(se); 


} 
} 


我 有 性 能 更 好 的 IDE 


虽然 在 本 文 的 例子 中 我 使 用 Gant an 了 查找 特定 味道 的 工具 ， 但 是 使 用 IDE 也 同样 可 以 解 
决 这 些 问题 。Eclipse IDE 就 有 很 多 静态 分 析 工 具 的 插件 。 但 我 仍然 推荐 使 用 自动 构建 工具 ， 
因为 这 样 可 以 在 其 他 环境 中 运 eR JÆ > ABMA IDE ° 


度量 


查找 重复 代码 的 度量 方法 是 在 代码 库 中 的 类 的 内 部 和 其 他 类 之 间 搜 索 代 码 重 复 。 没 有 工具 的 
话 ， 类 问 的 重复 就 更 难 评估 。 由 于 复制 的 代码 通常 都 会 发 生 一 些 轻 微 的 变化 ， 因 此 不 仅 要 度 
量 完全 相同 的 代码 ， 而 且 要 度量 相似 的 代码 ， 两 者 都 很 重要 。 


工具 


PMD 的 Copy/Paste Detector (CPD) 与 CheckStyle 这 两 种 开源 工具 可 以 用 于 在 整个 Java 
代码 库 中 查找 相似 的 代码 。 清 单 5 中 的 CheckStyle 配置 文件 例子 示范 了 如 何 使 用 


StrictDuplicateCode 模块 : 


清单 5. 使 用 CheckStyle 找到 至 少 10 行 重复 代码 


«module name-"StrictDuplicateCode"- 
«property name-"min" value="10"/> 
«/module» 


清单 5 中 的 min 属性 设置 了 CheckStyle 将 会 标记 出 的 最 小 重复 行 数 ， 以 供 查阅 。 在 这 样 的 
情况 下 ， 它 将 只 指示 出 那些 至 少 有 10 行 类 似 或 重复 的 代码 块 。 


图 3 展示 了 自动 构建 运行 后 ， 清 单 5 中 的 模块 设置 的 结果 : 


图 3. CheckStyle 报告 指示 代码 重复 度 过 高 





File Cdewbrewery-temp'srcvcom\beenbusiness\data\BeerDaolmpl.java 


Error Description 
Found duplicate of 5 lines in C:\devibrewery-temp\src\comibeeñbusiness\data\BeerDaolmpl.java, starting from line 54 


Found duplicate of 5 lines in Cdevibrewery-tempsrcicomWeenbusinessdataWBeerDaolmpl.java, starting from line 90 


重 构 


在 清单 6 中 ， 我 用 了 清单 4 中 的 重复 代码 ， 使 用 了 Pull Up Method 重 构 来 降低 重复 度 一 将 行 
为 从 较 大 方法 提取 到 一 个 抽象 类 方法 中 : 


清单 6. Pull Up Method 


} finally { 
closeDbConnection(rs, stmt, conn); 


J 


不 要 忘记 编写 i| 试 程序 


任何 时 候 改 变现 有 代码 ， 您 都 需要 用 诸如 JUnit 这 样 的 框架 AAA Nr us 。 修 改 现 
有 代码 是 存在 风险 的 ; 而 将 这 个 风险 降 到 最 低 的 一 种 方法 就 是 通过 测试 来 验证 该 行为 在 现在 
和 将 来 都 有 效 。 


重复 代码 是 难以 避免 的 。 我 永远 不 会 建议 一 个 团队 去 努力 实现 什么 无 重复 之 类 的 目标 ， 这 是 
不 切实 际 的 。 然 而 ， 确 保 代 码 库 中 的 重复 代码 不 会 增多 这 样 的 目标 是 可 以 实现 的 。 使 用 诸如 
PMD 的 CPD X CheckStyle 这 样 的 静态 分 析 工 具 ， 您 能 够 将 整个 分 析 过 程 作为 自动 构建 的 一 
部 分 ， 持 续 分 析 ， 确 定 代 码 重 复 度 高 的 区 域 。 


长 方法 (大 类 ) 


首 : 长 方法 (大 类 ) 


* 
佑 


hd 


度量 : 源 代 码 行 数 (SLOC ) 


工具 : PMD、JavaNCSS、CheckStyle 


重 构 : Extract Method ` Replace Temp with Query ` Introduce Parameter Object ^ Preserve 
Whole Object ` Replace Method with Method Object 


我 一 直 在 尝试 坚持 的 一 条 经 验 法 则 是 将 方法 限制 在 20 行 或 20 行 以 内 。 当 然 ， 这 个 原则 也 可 
能 会 有 例外 ， 但 如 果 我 的 方法 超过 20 行 的 话 ， 我 就 会 更 仔细 地 去 了 解 它 。 通 常情 况 下 ， 长 方 
法 和 条 件 复杂 度 是 息息相关 的 。 而 大 类 与 长 方法 之 间 又 有 着 必然 的 联系 。 我 可 以 给 您 展示 一 
个 2200 行 的 方法 ， 这 个 方法 是 我 在 需要 维护 的 一 个 项 目 上 发 现 的 。 我 将 整个 含有 25000 ft 
的 代码 的 类 打印 了 出 来 ， 让 我 的 同事 来 找 出 里 面 的 错误 。 这 么 说 吧 ， 当 我 把 打印 出 来 的 代码 
沿 着 走廊 卷 起 来 的 时 候 ， 他 们 就 已 经 同意 我 的 看 法 了 。 


清单 7 中 高 亮 显示 的 部 分 展示 了 一 个 长 方法 代码 味道 示例 的 一 小 部 分 : 


清单 7. 长 方法 代码 味道 


public void saveLedgerInformation() 1 

try { 

if (ledger.getId() !- null && filename == null) { 
getLedgerService().saveLedger(1ledger); 


) else { 
accessFiles().decompressFiles(files, filenames); 


} 

if (!files.get(0).equals(upload)) { 
upload = files.get(0); 
filename = filenames.get(0); 


if (invalidFiles.isUnsupported(filename) 
setError(fileName, message.getMessage()) 

) else { 

LedgerFile entryFile - accessFiles().add(upload, filename); 

if (fileType !- null && FileType.valueOf(fileType) !- null) { 
entryFile.setFileType(FileType.valueOf(fileType)); 


: 


—— 


getFileManagementService().saveLedger(ledger, entryFile); 

if (!FileStatus.OPENED.equals(entryFile.getFileStatus())) { 
getFileManagementService().importLedgerDetails(ledger); 

H 


if (uncompressedFiles.size() » 1) ( 
Helper.saveMessage(getText("ledger.file")); 
} 


if (user.getLastName() != null) { 
SearchInfo searchInfo = ServiceLocator .getSearchInfo(); 
searchInfo.setLedgerInfo(null); 
isValid - false; 
setDefaultValues(); 
resetSearchInfo(); 
if (searchinfoValid && ledger !- null) { 
isValid - true; 


} 


) catch (InvalidDataFileException e) { 

ResultType result - e.getResultType(); 

for (ValidationMessage message : result.getMessages()) ( 
setError(fileName, message.getMessage()); 

} 

ledger.setEntryFile(null); 


j 


在 过 去 的 几 年 里 ，SLOC 度量 方法 被 误 认为 是 高 效率 的 象征 。 尽 管 我 们 都 知道 ， 并 不 一 定 是 
行 数 越 多 越 好 。 但 说 到 复杂 度 ，SLOC 可 是 一 个 有 用 的 度量 方法 。 一 个 方法 〈 或 类 ) 的 行 数 
越 多 ， 将 来 维护 其 代码 就 可 能 越 难 。 

工具 


清单 8 中 的 脚本 为 长 方法 (大 类 ) 找到 了 SLOC 度量 方法 : 


清单 8. 识别 过 大 的 类 和 方法 的 Gant 脚本 


target(findLongMethods:"runs static code analysis")[ 
Ant.mkdir(dir:"target/reports") 
Ant.taskdef(name:"pmd", classname:"net.sourceforge.pmd.ant.PMDTask", 
classpathref:"build.classpath") 
Ant.pmd(shortFilenames:"true")[ 
codeSizeRules.each[ rfile -> 
ruleset(rfile) 


formatter(type:"xml", tofile:"target/reports/pmd report.xml") 
formatter(type:"html", tofile:"target/reports/pmd report.html") 
fileset(dir:"src")( 
include(name:"**/*,java") 
} 
} 
} 


我 又 使 用 了 Gant 访问 Ant API 来 执行 Ant 任务 。 在 清单 8 中 ， 我 调用 PMD 静态 分 析 工 具 来 
搜索 代码 库 中 的 长 方法 。PMD (连同 JavaNCSS 5 CheckStyle) 也 可 以 用 于 查找 长 方法 、 
大 类 以 及 其 他 代码 味道 。 


重 构 


清单 9 展示 了 用 Extract Method € M Jk xi d 清单 7 中 的 长 方法 代码 味道 的 一 个 例子 。 将 清单 
7 的 方法 中 的 行为 提取 到 清单 9 的 代码 中 以 后 ， 我 就 可 以 从 清单 7 的 
saveLedgerInformation() 方法 中 调用 新 建 的 isUserValid() 方法 了 : 


清单 9. Extract Method 重 构 


private boolean isUserValid(User user) { 
boolean isValid = false; 
if (user.getLastName() !- null) { 
SearchInfo searchInfo = ServiceLocator.getSearchInfo(); 
searchInfo.setLedgerInfo(null); 
setDefaultValues(); 
resetSearchInfo(); 
if (searchInfoValid && ledger !- null) { 
isValid - true; 
} 
} 


return isValid; 


w 


通常 ， 长 方法 和 大 类 也 暗示 着 存在 其 他 代码 味道 ， 如 条 件 复杂 度 和 重复 代码 。 因 此 ， 找 到 这 
些 长 方法 和 大 类 也 就 可 以 修复 其 他 的 问题 了 。 


味道 : 太 多 导入 
Lx : 传 出 耦合 (每 个 类 的 扇 出 (fan-out) ) 


f 


工具 : CheckStyle 


* 34 : Move Method ` Extract Class 


味道 


多 导入 表明 一 个 类 过 多 地 依赖 于 其 他 的 类 。 您 会 注意 到 ， 由 于 一 个 类 与 很 多 其 他 的 类 耦合 
得 太 紧 密 ， 修 改 这 个 类 会 导致 必须 对 很 多 其 他 的 类 进行 修改 ， 这 时 就 说 明 这 个 类 存在 这 种 代 
binis 。 清 单 10 中 的 多 个 导入 就 是 一 个 例子 : 


清单 10. 一 个 类 中 的 多 个 导入 


import com.integratebutton.search.SiteQuery; 
import com.integratebutton.search.OptionsQuery; 
import com.integratebutton.search.UserQuery; 
import com.integratebutton.search.VisitsQuery; 
import com.integratebutton.search.SiteQuery; 
import com.integratebutton.search.DateQuery; 
import com.integratebutton.search.EvaluationQuery; 
import com.integratebutton.search.RangeQuery 
import com.integratebutton.search.BuildingQuery; 
import com.integratebutton.search.IPQuery; 
import com.integratebutton.search.SiteDTO; 
import com.integratebutton.search.UrlParams; 
import com.integratebutton.search.SiteUtil; 


import java.text.DateFormat; 
import java.text.ParseException; 
import java.text.SimpleDateFormat; 
import java.util.ArrayList; 
import java.util.Calendar; 
import java.util.Collection; 
import java.util.Collections; 
import java.util.Date; 

import java.util.HashMap; 

import java.util.List; 

import java.util.Map; 

import org.apache.10g4j.Logger; 


度量 


am DEA 责任 的 类 的 一 个 方法 就 是 通过 传 出 耦合 度量 方法 ， 亦 指 扇 出 复杂 度 。 扇 出 复杂 
法 分 析 的 类 所 依附 的 每 一 个 类 赋值 1。 


工具 
清单 11 展示 了 一 个 用 CheckStyle 设置 最 大 扇 出 复杂 度数 的 例子 


清单 11. 使 用 CheckStyle 设置 最 大 扇 出 复杂 度 


«module name-"ClassFanOutComplexity"» 
«property name-"max" value="10"/> 
«/module» 


Refactoring to Patterns 


工厂 方法 模式 是 应 用 重 构 时 可 以 实现 的 多 种 设计 模式 之 一 。 用 工厂 方法 创建 类 无 需 显 式 定义 
正在 创建 的 实际 的 类 。 ee 。 当 根据 代码 味道 实现 重 构 时 ， 
您 也 可 以 使 用 其 他 的 设计 模式 ; 参见 参考 资料 查看 专门 研究 这 个 概念 的 书籍 的 链接 。 


重 构 


修复 由 于 太 多 导入 而 引发 的 耦合 过 紧 的 方法 有 很 多 种 。 对 于 诸如 清单 10 中 那样 的 代码 来 说 ， 
可 用 的 重 构 就 包括 Move Method $358 : 将 方法 从 单独 的 * Query 类 移动 到 Java 界面 ， 并 定义 
所 有 Query 类 必须 实现 的 通用 方法 。 然 后 再 使 用 工厂 方法 模式 ， 这 样 耦 合 度 就 与 办 面相 关联 
了 o 


通过 使 用 Gant 自动 构建 脚本 执行 CheckStyle Ant 任务 ， 我 可 以 搜索 代码 库 ， 查 找 过 多 依赖 
于 其 他 类 的 类 。 当 修改 这 些 类 中 的 代码 时 ， 就 能 够 实现 特定 的 重 构 (比如 Move Method) 和 
特定 的 设计 模式 ， 以 逐步 改进 可 维护 性 。 


£41..... THX GT 


持续 集成 (Continuous Integration * CI) 就 是 经 常 集成 变更 。 正 如 其 典型 的 实现 方式 一 样 ， 
每 当 对 项 目的 版 本 控制 储存 库 做 出 一 个 更 改 时 ， 运 行 于 独立 机 器 上 的 自动 CI| 服务 器 就 会 触发 
一 个 自动 构建 。 为 了 确保 清单 3 和 清单 8 中 的 脚本 可 以 在 对 数据 库 做 出 更 改 时 一 致 地 运行 ， 
您 需要 配置 一 个 诸如 Hudsona 这 样 的 CI 服务 器 (参见 参考 资料 ) » Hudson 是 以 WAR x 
件 的 形式 发 布 的 ， 您 可 以 将 它 放 入 任何 Java Web 容器 中 。 


Bl 清单 3 和 清单 8 中 的 例子 使 用 了 Gant， 下 面 我 就 简要 介绍 一 下 配置 Hudson CI 服务 器 
运行 Gant 脚本 的 步骤 : 


1. Æ Hudson 的 仪表 板 上 为 Hudson 安装 Gant 插件 : duin Manage Hudson > 3444 
Manage Plugins， 然 后 选择 Available 选项 卡 。 在 这 个 选项 卡 上 选中 Gant 插件 复 选 
框 ， 然 后 单 击 Install 按 钮 。 

2， 重 新 启动 Web 容器 (例如 ，Tomcat) 。 

. 选择 Manage Hudson， 然 后 选择 bd ca System ° # Gant installation 部 分 ， 键 入 

一 个 惟一 的 名 称 以 及 Groovy 安装 到 运行 Hudson 的 机 器 上 的 位 置 。 保 存 所 作 更 改 。 

4. 返回 到 仪表 板 (选择 Hudson 链 接 ) > Pa ^ existing Hudson Job， 再 选择 
Configure > /A4/$ € xx Add build stepiz4z > %44 Invoke Gant scripti » 


配置 Hudson， 使 其 运行 使 用 Gant 编写 的 自动 构建 脚本 。 一 旦 诸如 长 方法 和 条 件 复 杂 度 这 样 
的 代码 味道 被 引入 到 代码 库 中 ， 您 立刻 就 会 得 到 与 它们 相关 的 度量 方法 的 反馈 。 


其 他 味道 与 重 构 


并 非 所 有 的 味道 都 有 相关 的 度量 方法 。 但 是 ， 静 态 分 析 工 具 能 够 揭露 的 味道 不 止 我 所 示范 的 
这 些 。 表 1 列举 了 其 他 的 代码 味道 、 工 具 、 以 及 可 能 的 重 构 例子 : 


Š 1. 其 他 味道 与 重 构 


味道 工具 重 构 
死 代 码 PMD Remove Code 
临时 字段 PMD Inline Temp 


不 一 致 / 拘谨 


(uncommunicative ) CheckStyle ` 


Rename Method ` Rename Field 


的 名 称 RS 
其 参数 列表 PMD Replace Parameter with Method ` Preserve 


Whole Object ` Introduce Parameter Object 


本 文 提供 了 一 种 使 代码 味道 与 一 种 度量 方法 相关 的 模式 ， 这 种 度量 方法 可 以 配置 为 通过 自动 
静态 分 析 工 具 标 记 。 您 可 以 使 用 或 不 使 用 特定 的 设计 模式 来 进行 重 构 。 这 为 您 提供 了 一 个 以 
可 重复 的 方式 一 致 地 查找 和 修复 代码 味道 的 框架 。 我 坚信 本 文 的 例子 也 有 助 于 您 使 用 静态 分 
析 工 具 来 查找 本 文 未 涉及 到 代码 味道 。 
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自动 生成 开发 人 员 和 用 户 文档 


项 目的 文档 化 通常 都 是 交付 软件 产品 时 不 可 避免 的 难题 。 但 是 想象 一 下 如 果 仅 需 单 击 一 个 按 
钮 就 能 够 生成 文档 呢 ? 在 本 期 的 让 开发 自动 化 中 ， 自 动 化 专家 Paul Duvall 阅 述 了 如 何 运 用 开 
源 工 具 自动 生成 统一 建 模 语言 (Unified Modeling Language > UML) 图 、 构 建 图 、 实 体 关 系 
图 (entity-relationship diagram > ERD) 乃至 用 户 文档 。 


很 少 有 软件 开发 人 员 愿 意 为 他 们 的 软件 开发 项 目 编写 文档 。 然 而 ， 除 非 您 永远 不 想 完 成 您 的 
项 目 ， 或 者 您 永远 独立 进行 软件 开发 ， 又 或 者 您 没有 用 户 一 这 对 一 个 项 目 来 说 可 不 是 一 个 好 
现象 ， 否 则 您 就 需要 用 一 种 方式 来 向 别人 交待 您 的 软件 的 用 途 。 有 些 开 发 者 误解 了 Agile 
Manifesto 的 “可 运行 的 软件 优 于 全 面 的 文档 ”的 说 法 ， 以 为 根本 不 需要 任何 的 文档 资料 (请 
参阅 参考 资料 ) 。 另 一 方面 ， 多 余 的 文档 对 用 户 或 其 他 开发 人 员 来 说 也 是 一 个 负担 。 我 通常 
寻找 一 种 中 间 办 法 。 您 猜 对 了 : 本 文 将 向 您 展示 如 何 运 用 自动 化 来 简化 项 目 文档 的 生成 过 
程 ， 从 而 减轻 这 方面 的 负担 。 


关于 本 系列 


作为 开发 人 人员， 我 们 致力 于 为 用 户 自动 化 流程 ; 但 许多 开发 人 员 鸣 忽 了 自动 化 我 们 自己 的 开 
发 流程 的 机 会 。 为 此 ， 我 们 编写 了 让 开发 自动 化 系列 文章 ， 专 门 探讨 软件 开发 流程 自动 化 的 
实践 应 用 ， 为 您 介绍 何 时 以 及 如 何 成 功 应 用 自动 化 。 


按照 我 的 经 验 ， 有 两 个 关键 性 的 问题 制约 着 软件 开发 的 文档 化 。 第 一 个 问题 ， 似 乎 没有 人 会 
去 阅读 文档 。 第 二 个 常见 问题 就 是 几乎 是 在 编写 文档 的 同时 ， 它 就 已 经 过 时 了 。 这 两 个 问题 
是 有 着 因果 联系 的 : 如 果 文 档 总 是 保持 最 新 ， 那 么 人 们 就 更 有 可 能 去 阅读 它 。 自 动 化 生成 文 
档 便 可 以 解决 这 两 个 问题 ， 它 可 以 保持 文档 的 时 效 性 ， 从 而 使 它 对 您 的 软件 用 户 更 加 有 用 。 


自动 化 也 可 能 对 其 他 类 型 的 文档 有 利 ， 但 在 本 文中 我 将 着 重 阔 述 如 何 让 那些 令 人 痛苦 的 文档 
化 任务 自动 化 (请 参阅 参考 资料 查找 下 面 列表 中 提 到 的 工具 的 链接 ) 


e 使 用 UMLGraph 生成 当前 源 代码 的 UML 图。 

。 使 用 SchemaSpy 创建 实体 关系 图 (ERD) ， 归 档 数 据 库 中 的 表格 和 关系 。 
e 使 用 Grand 生成 构建 目标 以 及 它们 之 间 的 关系 的 Ant 构建 图 。 

e 使 用 Doxygen 生成 源 代码 文档 。 

e 使 用 DocBook 制作 用 户 文档 。 


我 将 使 用 一 般 的 方法 阅 述 以 下 内 容 : 


1. 描述 手动 执行 每 一 项 任务 遇 到 的 问题 。 
2. 呈现 一 个 结合 使 用 Apache Ant 和 相关 的 文档 / 图 表 生 成 工具 实现 自动 化 的 例子 


8. 展示 一 个 基于 代码 示例 的 脚本 生成 文档 的 图 象 。 


和 本 系列 前 面 的 文章 一 样 ， 文 中 所 有 示例 都 使 用 可 免费 获得 的 开源 工具 ， 您 可 以 在 自己 的 项 
目 中 使 有 用。 有些 工具 (例如 ，UMLGraph 和 Grand) 会 使 用 一 个 附带 的 GraphViz 工具 ， 该 工 
具 要 用 到 一 个 由 特定 工具 生成 的 dot 文件 。 


将 代码 反 向 工程 到 UML 中 


我 曾 遇 到 过 一 些 拥 有 十 分 美观 的 UML 图 的 项 目 一 在 项 目的 初始 阶段 。 问 题 是 ， 在 某 种 特殊 情 
况 下 ， 技 术 负 责 人 无 法 使 模型 与 源 代码 同步 。 或 者 需要 将 宝贵 的 时 间 浪 费 在 将 源 代 码 手动 反 
向 工程 到 模型 中 。 这 两 种 情况 都 不 尽 如 人 意 。 如 果 模 型 无 法 如 实地 展示 签 入 到 版 本 控制 库 中 
的 代码 ， 那 么 这 个 UML 图 构造 的 再 美观 也 毫 无 意义 。 如 果 您 没有 根据 实际 的 代码 制定 决策 ， 
那么 您 可 能 就 要 面临 随 之 而 来 的 很 多 问题 。 


您 可 以 在 构建 过 程 中 生成 图 示 ， 并 建立 一 个 持续 集成 《Continuous Integration > CI) 环境 来 
即时 地 (或 定期 地 ) 创建 图 示 。 这 样 您 就 能 够 制作 出 有 益 于 决策 、 易 于 创建 且 始 终 反 映 最 新 
情况 的 图 示 了 。 


清单 1 使 用 Ant、UMLGraph 以 及 Graphviz 对 源 代码 进行 文档 化 : 
清单 1. 使 用 UMLGraph 文档 化 工具 的 Ant 脚本 


«property name="reports.dir" value="${basedir}/reports"/> 
<mkdir dir="${reports.dir}"/> 
«path id="project.path"> 
<pathelement path="${basedir}/src"/> 
«pathelement path-"$[basedirj/lib"/» 
«/path» 
«javadoc sourcepath-"$[basedirj/src" destdir-'$[reports.dirj" 
classpathrefz"project.path" access-'private'"» 
«doclet name-z"org.umlgraph.doclet.UmlGraphDoc" 
path-z"UMLGraph.jar"» 
«param name-z"-attributes" /> 
«param namez"-enumerations" /> 
«param namez"-enumconstants" /> 
«param namez"-operations" /> 
«param name-z"-qualify" /> 
«param namez"-types" /> 
«param namez"-visibility"/» 
«/doclet» 
«/javadoc» 
«apply executable-"dot" dest-"$[reports.dirj" parallel-"false'"» 
«arg valuez'-Tpng"/» 
«arg valuez'-o"/» 
«targetfile/» 
«srcfile/» 
«fileset dir-"$[reports.dirj" includes-"*.dot"/» 
«mapper type-z"glob" fromz"*.dot" to="*.png"/> 
«/apply» 


清单 1 中 ， 我 结合 使 用 UMLGraph 和 Javadoc 在 Javadoc HTML 报告 内 部 生成 一 些 基本 的 
UML 类 图 。 为 了 自 定义 展示 在 每 一 个 类 图 中 的 信息 ， 调 用 Uml6raphpoc 时 ， 我 传递 了 如 下 属 
性 : 


使 用 GraphViz 制图 


要 正常 使 用 UMLGraph， 您 必须 先 安装 Graphviz 工具 (请 参阅 参考 资料 ， 并 且 计 算 机 的 系 
统 路 径 中 必须 包含 Graphviz .dot 文件 。 


e -attribute 为 类 显示 字段 。 

e „enumeration 展示 不 同 的 枚 举 。 

*  -enumconstant 为 枚 举 展 示 可 能 的 值 。 
e -operation 为 类 显示 Java 方法 。 

e -qualify 显示 完全 限定 类 名 。 

e -type 显示 参数 数据 类 型 和 返回 类 型 


e „visibility 展示 字段 和 方法 修改 语 : public ^ protected ^ private 或 default ° 


图 1 展示 了 用 UMLGraphshows 生成 到 HTML 中 的 LoginDaoImpl 类 及 其 关系 的 UML AH : 


图 1. 用 UMLGraph 生成 的 UML 图 
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请 单 击 此 处 查看 完整 图 形 。 


UMLGraph 能 够 生成 更 复杂 的 关系 和 其 他 细节 。 但 是 ， 即 便 是 这 个 简单 例子 中 极其 基本 的 
UML 类 图 ， 就 已 经 提供 了 相当 多 的 信息 。 它 也 可 以 根据 当前 的 代码 库 快捷 、 形 象 地 展示 软 
件 。 它 防止 了 “代码 应 该 是 这 样 的 ” 这 种 陈述 方式 ， 并 且 有 益 于 做 出 更 好 的 决策 (关于 描述 了 
多 种 可 以 自 定义 UMLGraph 输出 的 属性 的 链接 ， 请 参阅 参考 资料 ) 。 


数据 库 文 档 化 


浅 。 实 体 关系 图 (ERD) 是 实现 数据 库 可 视 化 的 最 流行 的 图 示 类 型 。 大 多 数 创建 ERD 的 工具 
(例如 ，ERWinfor) 都 需要 手动 生成 ERD。 虽 然 我 将 要 示范 的 工具 SchemaSpy 无 法 与 现存 
的 一 些 更 复杂 的 工具 媲美 ， 但 是 它 能 够 提供 数据 库 的 高 级 ERD 视图 一 以 及 约束 、 关 系 等 。 
而 有 全， 通过 自动 构建 来 运行 它 ， 您 就 可 以 轻松 地 从 您 的 版 本 控制 库 中 检查 数据 定义 语言 

( Data Definition Language * DDL) 的 最 新 显示 。 


清单 2 中 的 Ant 脚本 使 用 SchemaSpy 工具 来 创建 Javadoc 格式 的 文件 : 
清单 2. 结合 使 用 SchemaSpy ` Ant 和 Javadoc 


«property name-"reports.dir" value-"$[basedirj"/» 
«java jar-z"schemaSpy 3.1.1.jar" 
output-z"$[reports.dirj/output.1log" 
errorz'"$(reports.dir)/error.log" 

fork="true"> 

<arg line="-t mysql"/> 

<arg line="-host localhost"/> 

<arg line="-port 3306"/> 

<arg line="-db brewery"/> 

<arg line="-u root"/> 

<arg line="-p sa"/> 

<arg line="-cp mysql-connector-java-5.0.5-bin.jar"/> 
«arg line="-o ${reports.dir}"/> 

</java> 


清单 2 使 用 java Ant 任务 调用 SchemaSpy， 传 递 了 很 多 属性 : 


-t 为 数据 库 类 型 (有 效 值 为 mysql ^ ora ^ db2 ， 等 等 。) 
e -host 为 托管 数据 库 的 计算 机 名 。 

e -port 为 数据 库 URL 的 端口 数 。 

。 -u 为 数据 库 用 户 名 。 

e -p 为 数据 库 密码 。 

e -cp 为 类 路 径 (用 于 指示 数据 库 驱 动 程序 JAR 文件 的 位 置 ) 。 
-0 为 输出 目录 的 位 置 。 


这 些 SchemaSpy 的 命令 行 属性 用 于 生成 显示 ERD 的 HTML 文件 ， 如 图 2 所 示 : 


图 2. 用 SchemaSpy 和 Ant 创建 的 ERD 


SchemaSpy - brewery - Columns - Mozilla Firefox 


File Edt View History eres 





| Tables | Relationships Utility Tables Constraints Anomalies | Columns | 


SchemasSpy Analysis of brewery - Columns 


Generated by SchemaSpy on Mon May 19 19:31 EDT 2008 


(v) Related columns [v] Constraint names [z) Comments [vILegend 


brewery contains 8 columns: — .— — 












BEER NAME varchar 
BREWER beer varchar 50 


ID beer bigint 19 0 

PASSWORD user varchar 50 

STATE state varchar 2 

USERNAME user varchar 16 

date_received beer date 0 y null 

description state varchar 50 二 null 
通过 结合 使 用 多 种 工具 、 作 为 构建 的 一 部 分 针对 数据 库 执行 ERD 生成 脚本 ， 并 调度 ERD 生 
成 ， 您 就 可 以 在 开发 过 程 中 轻松 、 快 速 地 做 出 很 多 数据 库 决策 。 


图 解构 建 过 程 


通常 ， 构 建 脚本 在 相关 的 目标 之 间 有 着 复杂 的 关系 。 d 过 许多 构建 脚本 足 有 1000 多 行 ， 
含有 大 量 多 余 的 重复 行 。 如 果 没 有 自动 构建 的 高 级 视图 ， 这 些 构建 脚本 会 很 难处 理 。 要 想 快 
速 确 定 一 个 构建 过 程 正 在 处 理 的 内 容 ， 一 个 有 效 的 方法 就 是 创建 一 个 目标 和 关系 图 。Ant 目标 
的 一 个 可 视 模型 能 够 帮助 您 作出 更 有 效 、 更 明智 的 决策 ， 以 改进 构建 脚本 的 设计 。 


结合 使 用 Ant、Grand 和 Graphviz， 您 就 可 以 创建 出 构建 目标 We 的 可 视 表 示 。 有 很 多 的 
有 具 都 旨 在 可 视 化 表示 Ant 目标 。 而 Grand 的 一 个 优势 便 在 于 它 运 用 了 Ant API， 这 样 无 论 
Ant 脚本 是 否 完全 有 效 ， 它 都 可 以 创建 图 示 。 


清单 3 De Ant 脚本 展示 了 如 何 运 用 Grand 工具 来 创建 Ant 脚本 目标 的 可 视 表 示 ， 包 括 目标 
间 的 依赖 性 


清单 3. 使 用 Ant 和 Grand 创建 Ant 目标 的 图 示 
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«target name-"create-ant-diagram"» 
«property name-"file.type" value-"pdf"/» 
«typedef resource-"net/ggtools/grand/antlib.xml" 
classpath-"grand-1.8.jar"/» 
«grand output-"build.dot" buildfile-"$[basedirj/build.xml"/-» 
«exec executable-"dot"- 
«arg line-"-T$[file.type) -Gsize-11.69,8.27 -Grotate-90 -o build.$[file.type) 
$(grand.output.filej"/» 
«/exec» 
«/target» 


在 清单 3 中 ， 首 先 ， 我 通过 指向 grand-1.8.jar 创建 了 任务 。 接 着 ， 我 在 buildfile 属性 中 
为 正在 分 析 的 构建 文件 命名 。 output 属性 是 我 正在 创建 的 Graphviz 文件 (我 将 其 命名 为 
build.dot ) 。 最 后 ， 我 调用 了 dot 可 执行 文件 生成 buildfile 的 构建 目标 的 PDF。 图 3 
展示 了 这 种 文件 的 一 个 例子 : 


图 3. 使 用 Ant、Grand 和 GraphViz 生成 Ant 目标 的 图 示 


n j [run-compile-tests] 
^ o »* 
2 (run-architecture-tests] 










1 
^. .--Y*( compile-tests } - - - 
7 als ,* 


r 


a 


all-no-db de [run-load-tests] 


run-load-tests Y ^ ^ 


我 可 以 运用 这 些 图 表 分 析 已 完成 的 项 目 ， 或 者 为 开发 中 的 项 目 优化 构建 过 程 。 


代码 文档 化 


如 果 我 想 记 住 为 什么 创建 了 一 个 新 的 Java 类 或 方法 ， 那 么 我 会 写 一 个 Java 代码 注释 。 但 如 
果 我 想 更 全 面 地 了 解 新 建 的 类 、 方 法 和 属性 ， 那 么 我 就 需要 一 个 代码 文档 化 的 工具 了 。 多 年 
以 来 ，Java 平台 都 将 Javadoc 作为 生成 代码 文档 的 方法 ， 用 于 代码 库 中 的 所 有 类 。 事 实 

上 ， javadoc 任务 已 成 了 Ant 中 的 标准 ， 它 也 确实 能 够 生成 代码 文档 。 然 而 ， 它 需要 由 开发 
人 员 负 责 将 一 些 难 看 的 HTML 标记 诅 入 到 Java 源 代码 注释 中 。 例 如 ， 清 单 4 所 示 的 运用 
Javadoc 的 代码 注释 : 


清单 4. Javadoc 的 代码 注释 


p 

This is <i>the</i> LoginServiceImpl class. 
«p» 

Refer to «a hrefz'"url.html'"» 

LoginService overviewc/a» for more details. 
«p» 


There is one type of supported (Qlink LoginServiceImpl }: 
«ul» 
<li>{@link LoginServiceImpl } (this class)«/li» 
«/ul» 
2 


如 果 使 用 Doxygen， 代 码 注 释 就 会 更 简洁 ， 省 去 了 嵌入 的 HTML 标记 ， 如 清单 5 所 示 : 
清单 5. 使 用 Doxygen 文档 化 工具 的 Ant 脚本 


Va 

This is <i>the</i> LoginServiceImpl class. 
Refer to Nref LoginService for more details. 
There is one type of supported LoginService: 
- LoginServiceImpl (this class) 

BA 


Javadoc 和 Doxygen 都 支持 自动 生成 代码 文档 ， 但 是 使 用 Doxygen 比较 简单 ， 它 提供 了 一 
种 更 直观 的 方法 来 用 注释 标注 源 代码 。 清 单 6 中 的 Ant 代码 片断 展示 了 Doxygen 最 基本 的 使 
用 方法 : 


清单 6. 使 用 Doxygen 文档 化 工具 的 Ant 脚本 


«target name="generate-doxygen"> 

«taskdef name-z"doxygen" classname-"org.doxygen.tools.DoxygenTask" 
classpath-z"ant-doxygen.jar" /> 

«doxygen configFilename-z"Doxyfile"» 

«property name-"INPUT" value-"$[src.dirj" /> 

«property name-"RECURSIVE" value-"yes" /> 

«/doxygen» 

</target> 


在 清单 6 中， Doxyfile 的 configFilename 值 是 由 Doxygen 自动 生成 的 配置 文件 的 名 称 ; 您 
可 以 重新 定义 。 图 4 展示 了 一 个 LoginpaoImpl 类 的 HTML 报告 的 例子 ， 它 是 由 清单 6 中 的 
Doxygen 示例 生成 的 : 


图 4. HTML Doxygen 文档 
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请 单 击 此 处 查看 完整 图 形 。 


通过 在 自动 构建 中 创建 Doxygen 文档 ， 您 可 以 获得 有 关 某 个 API 的 最 新 的 使 用 信息 。 


用 户 文档 


到 目前 为 止 ， 您 可 能 一 直 在 想 ， 自 动 生成 技术 文档 固然 不 错 ， 但 是 最 头 疝 的 是 创建 用 户 文 
档 。 在 编写 自己 的 用 户 文档 时 ， 我 发 现 大量 的 时 间 都 浪费 在 文档 内 部 的 复制 、 粘 贴 上 。 分 析 
了 该 过 程 之 后 ， 我 决定 将 诸如 版 本 号 、 文 件 名 等 内 容 定 义 到 单一 源 中 ， 以 此 来 实现 这 些 内 容 
的 生成 自动 化 。 而 且 我 可 以 运用 XML 和 可 扩展 样式 语言 (Extensible Stylesheet Language * 
XSL) 将 内 容 从 格式 化 中 分 离 出 来 ， 这 样 我 只 要 对 一 个 样式 做 一 个 简单 的 修改 就 可 以 使 文档 的 
观感 发 生 显著 的 变化 。 


DocBook 工具 已 存在 数 年 之 久 ， 它 使 您 能 够 用 XML 定义 文档 ， 并 能 够 以 包括 HTML 和 PDF 
在 内 的 多 种 格式 生成 文档 。DocBook 提供 了 一 种 为 编写 者 定义 模板 的 模式 。 


清单 7 结合 使 用 Ant、 一 个 DocBook XSL 文件 和 XSL Formatting Objects (XSL-FO) 来 生成 
PDF 格式 的 用 户 文档 (请 参阅 参考 资料 ) 


清单 7. 使 用 Ant、DocBook 和 FO 创建 PDF 


«target name-"pdf" depends-"init" description-"Generates PDF files from DocBook XML"> 
«property name-"fo.stylesheet" value-"$(docbook.xsl.dir)/fo/docbook.xsl" /> 
«xslt style-"$[fo.stylesheet)" extension-".fo" basedir-"$[src.dirj" destdir-"$[fo.dirj" 

«classpath refid-"xalan.classpath" /> 
«include name-"$[guidej.xml" /> 
«/xslt» 
«property name-"fop.home" value-"lib/fop-0.94" /> 
«taskdef name-"fop" classname-"org.apache.fop.tools.anttasks.Fop"» 
«classpath» 
«fileset dir-"$[fop.homej/lib"- 
«include name-"*.jar" /> 
«/fileset» 
«fileset dir-"$[fop.homej/build"» 
«include name-"fop.jar" /> 
«include name-"fop-hyph.jar" /> 
«/fileset» 
«/classpath» 

«/taskdef» 

«fop format-"application/pdf" fofile-"$[fo.dirj/$[guide).fo" 

outfile-"$[doc.dir)/$[guide).pdf" /> 

«/target» 
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图 5 展示 了 由 清单 7 中 的 脚本 生成 的 PDF 的 一 部 分 : 


图 5. 用 户 指南 文档 的 PDF 











Chapter 30. Installation 
Requirements 


Tested Environments 


The Brewery 2.0.5 installation has been tested on Linux Red Hat Enterprise Linux AS 5 32-bit and the 
Windows 2003 environments. It's possible that the installation may work in other Linux and Windows 
environments, 1t has only been tested in these environments. 


Required Software 


Many of the servers and services that make up Brewery 2.0.5 are automatically installed as part of this 
installation. However, there are certain tools that must be manually installed and configured - as listed 
in Table 2. The software name, version, description, and URL hyperlinks (for download) are indicated 
in the table. 


由 于 我 的 全 部 内 容 都 是 用 基于 文本 的 XML 定义 的 ， 所 以 我 可 以 轻松 地 写 出 令 文 档 发 生 显著 变 
化 的 脚本 。 此 外 ， 我 可 以 将 这 些 文档 做 为 构建 过 程 的 一 部 分 生成 ， 进 而 为 定义 诸如 版 本 、 定 
义 、 缩 写 、 文 件 名 以 及 目录 之 类 的 元 素 提 供 一 个 单一 的 标准 源 。 


文档 化 无 需 手 动 操作 


希望 阅读 本 文 之 后 ， 您 能 够 了 解 到 可 以 通过 有 效 的 方法 自动 生成 文档 。 在 我 看 来 ， 文 档 化 最 
关键 的 地 方 就 在 于 交流 ， 而 非 生 成 文档 的 过 程 。 我 向 您 描述 的 文档 化 工具 和 技术 能 够 帮助 您 
保持 文档 的 精确 性 和 实效 性 ， 从 而 清除 了 文档 之 所 以 被 忽视 的 症结 所 在 一 信息 过 时 。 


让 开发 自动 化 : 利用 |vy 管理 依赖 项 


使 用 公共 存储 库 和 Apache Ant 共享 其 他 项 目的 源 代码 


管理 项 目 和 工具 之 间 的 源 代码 依赖 项 往往 非常 困难 ， 但 并 不 一 定 总 是 如 此 。 在 这 一 期 让 开发 
自动 化 "中 ， 自 动 化 专家 Parl Duvall 介绍 了 如 何 利 用 Apache Ant 项 目 中 的 Ivy 依赖 项 管理 器 
来 处 理 所 有 重要 Java 项 目 必 须 管 理 的 无 数 依赖 项 。 


实际 上 ， 所 有 软件 开发 项 目 都 必须 依靠 来 自 其 他 项 目的 源 代 码 。 例 如 ， 许 多 项 目 可 能 依靠 
log4j 等 日 志 记录 工具 和 Struts 之 类 的 Web 框架 。 您 的 开发 团队 不 会 维护 其 他 项 目的 源 代 
码 ， 但 要 依靠 其 AP| 来 实现 项 目 中 的 定制 软件 。 您 的 软件 所 依靠 的 其 他 项 目 数量 越 多 ( 包括 
这 些 项 目 自身 的 依赖 项 ) ， 构 建 软件 就 变 得 越 复杂 。 


关于 本 系列 


作为 开发 人 员 ， 我 们 致力 于 为 用 户 自 动 化 流程 ; 但 许多 开发 人 员 足 忽 了 自动 化 我 们 自己 的 开 
发 流程 的 机 会 。 为 此 ， 我 们 编写 了 让 开发 自动 化 系列 文章 ， 专 门 探讨 软件 开发 流程 自动 化 的 
实践 应 用 ， 为 您 介绍 何 时 以 及 如 何 成 功 应 用 自动 化 。 


我 已 经 看 到 许多 团队 使 用 各 种 不 完善 的 技术 ， 尝 试 解 决 这 种 难题 : 


e 将 全 部 有 依赖 关系 的 项 目 (JAR 文件 ) 放 在 一 个 目录 中 ， 此 目录 将 签 入 项 目的 版 本 控制 
存储 库 。 这 种 技术 不 必要 地 增加 了 存储 库 的 大 小 ， 使 得 管理 版 本 差异 极为 困难 。 

e. 将 有 依赖 关系 的 JAR 分 配 到 一 个 公共 文件 服务 器 上 ， 使 团队 无 法 控制 版 本 更 改 。 

e 手动 将 JAR 文件 复制 到 各 开发 人 员工 作 站 上 的 指定 位 置 。 这 种 方法 使 得 确定 丢失 的 文件 
或 修正 版 本 极为 困难 。 

e 执行 一 条 HTTP cet 命令 ， 将 文件 下 载 到 开发 人 员 的 工作 站 ， 手 动 执 行 或 将 其 作为 自动 
构建 的 一 部 分 。 这 种 技术 会 造成 未 受 管理 的 JAR 文件 。 


我 参加 过 一 个 中 型 项 目 ， 包 含 1,000 个 Java 类 和 100 多 个 有 依赖 关系 的 JAR 文件 。 (RN 
选择 了 第 一 种 不 完美 的 技术 : 将 所 有 JAR 签 入 项 目的 版 本 控制 存储 库 。) 图 1 显示 了 可 能 在 
此 类 项 目 中 看 到 的 一 小 部 分 依赖 项 的 类 型 : 


图 1. Web 开发 项 目 中 的 JAR 依赖 项 示例 





Transfixed on transitive dependencies 


传递 依赖 ( Transitive dependency) 是 一 个 复杂 的 术语 ， 但 表示 的 是 |vy 提供 的 一 种 简单 而 强 
大 的 特性 。 某 些 JAR 文件 依赖 于 其 他 JAR， 这 样 才 能 正常 工作 。 使 用 |lvy， 您 只 需 一 次 性 声 
明 一 个 组 件 的 依赖 项 。 此 后 ， 仅 需 了 解 一 个 项 目的 主要 JAR 文件 ， 而 无 需 了 解 它 的 所 有 JAR 
文件 依赖 项 。 如 果 您 体验 过 手动 查找 依赖 项 的 痛苦 一 一 无 论 是 通过 文档 还 是 通过 研究 代码 ， 
您 就 会 发 现 ， 此 特性 本 身 就 值得 您 付出 时 间 在 项 目 中 配置 |vy。 参 见 本 文 依赖 于 依赖 项 一 节 了 
解 更 多 细节 。 


图 1 表现 出 ，Brewery 项 目的 源 代码 依赖 于 Hibernate ` Struts 2、MySQL Connector 和 
Cobertura。 而 Cobertura 又 依赖 其 他 JAR， 如 asm-2.2.1 jar ` jakarta-oro-2.0.8 jar 和 log4j- 
1.2.9.jar。 此 外 ，asm-2.2.1.jar 依赖 asm-tree-2.2.1.jar。 这 仅仅 是 可 能 出 现 的 各 类 嵌 套 依赖 项 
的 一 个 简单 示例 。 即 便 是 某 个 JAR 的 版 本 不 正确 ， 您 也 会 体验 到 难以 排除 的 问题 ， 例 如 编译 
错误 或 意料 之 外 的 行为 。 


Apache Maven 构建 管理 和 项 目 管理 工具 已 经 吸引 了 Java 开发 人 员 的 注意 。Maven 引入 了 
JAR 文件 公共 存储 库 的 概念 ， 可 通过 公开 的 Web 服务 器 访问 (4A ibiblio) 。Maven 的 方法 
减少 了 JAR 文件 膨胀 的 情况 ， 不 会 占用 大 多 数 版 本 控制 存储 库 。 但 使 用 Maven 时 ， 它 会 鼓 
励 您 采用 其 “惯例 优 于 配置 " 的 方法 来 构建 软件 ， 这 会 制约 您 定制 构建 脚本 的 灵活 性 。 


如 果 您 多 年 来 一 直 使 用 Apache Ant， 现 在 希望 获得 使 用 公共 存储 库 的 优势 ， 又 该 如 呢 ? 您 是 
否 不 得 不 接受 Maven 的 构建 方法 来 获得 这 些 收 益 ? 幸运 的 是 ， 答 案 是 否定 的 ， 这 是 由 于 一 种 
称 为 Apache Ivy 的 工具 一 Ant 的 一 个 子 项 目 。lvy 提供 了 最 一 致 、 可 重复 、 易 于 维护 的 方 
法 ， 来 管理 项 目的 所 有 构建 依赖 项 (在 参考 资料 部 分 中 可 以 找到 Maven 和 Ivy 的 比较 ) 。 这 
篇 文章 介绍 了 安装 和 配置 vy 来 管理 依赖 项 的 基础 知识 ， 指 出 了 可 参考 的 更 多 信息 。 


AT] 


开始 使 用 Ivy 非常 简单 ， 只 需 创 建 两 个 Ivy 特有 的 文件 ， 添 加 一 些 Ant B 48 FP T. 9 Ivy 特有 的 
文件 是 ivy.xml 和 一 个 |vy 设置 文件 。ivy.xml 文件 中 列举 了 项 目的 所 有 依赖 项 。 
ivysettings.xml 文件 (可 以 随意 为 此 文件 命名 ) 用 于 配置 从 中 下 载 有 依赖 关系 的 JAR 文件 的 
存储 库 。 


清单 1 展示 了 一 个 简单 的 Ant 脚 本 ， 它 调用 了 两 个 Ivy 任务 : ivy:settings 和 


ivy:retrieve ? 
清单 1. 使 用 Ivy 的 简单 Ant 脚本 


«target name-"init-ivy" depends-"download-ivy"» 
«ivy:settingsfile-"$[basedirj)/ivysettings.xml" /> 
«ivy:retrieve/» 

</target> 


在 清单 1 中 ， ivy:settings 定义 了 Ivy 设置 文件 。 对 ivy:retrieve 的 调用 从 ivy.xml 声明 的 
一 个 存储 库 中 检索 JAR 文件 。 


4C lvy 


下 载 并 使 用 Ivy 的 方法 有 几 种 。 第 一 种 是 手动 将 Ivy JAR 文件 下 载 到 Antlib 目录 中 ， 也 可 下 
载 到 Ant 脚本 的 类 路 径 中 定义 的 某 个 目录 中 。 我 迷 上 了 自动 化 ， 所 以 更 倾向 于 使 用 自动 化 替 
代 方 案 : 下 载 lvy 的 JAR 文件 ， 在 Ant 目标 中 配置 类 路 径 。 清 单 2 展示 了 这 种 技术 的 示例 : 


清单 2. 使 用 Ant 自动 安装 Ivy 


<?xml versionz"1.0" encoding-"iso-8859-1"?» 

«project name-z"test-ivy" default-"init-ivy" basedirz"." 
xmlns:ivy-"antlib:org.apache.ivy.ant" xmlns-z"antlib:org.apache.tools.ant"- 
«property name-"ivy.install.version" valuez"2.0.0-beta2" /> 

«property name-z"ivy.home" valuez"$[user.homel/.ant"/» 

«property name-"ivy.jar.dir" value-"$[ivy.homej/lib" /> 

«property name-z"ivy.jar.file" value-'"$[ivy.jar.dir)/ivy.jar" /> 


«taskdefresource-z"org/apache/ivy/ant/antlib.xml" 
uri-"antlib:org.apache.ivy.ant" classpath-"$[ivy.jar.dirj/ivy.jar"/» 


«target name-"download-ivy"» 
«mkdir dir-"$[ivy.jar.dirj"/» 
«get srcz'"http://www.integratebutton.com/repo/ 
$(ivy.install.versionj/ivy-2.0.0-beta2.jar" 
dest-"$[ivy.jar.filej"usetimestamp-"true"/» 
</target> 


</project> 


清单 2 中 的 第 二 行 定义 了 XML 名 称 空间 。 antlib Æ ivyjar 文件 中 引用 antlib.xml » 4-4 83 
xmlns 指明 了 ivy Ant 任务 的 完全 限定 路 径 。 s(user.home)/.ant 的 ivy.home 值 是 jivyJjar X 
件 下 载 的 目标 位 置 。 taskdef 定义 了 ivy Ant 任务 ， 用 其 类 路 径 的 位 置 。 download-ivy A 
标 下 载 ivy-2.0.0-beta2.jar 并 使 用 dest 属性 为 其 重 命 


一 旦 下 载 并 配置 了 Ilvy， 就 可 以 使 用 任意 Ivy Ant 任务 (如 清单 1 中 调用 的 两 个 任务 ) 。 


创建 配置 脚本 


ivy.xml 文件 是 必 不 可 少 的 ， 您 在 此 文件 中 定义 项 目的 全 部 有 依赖 关系 的 JAR。 清 单 3 展示 了 
一 个 示例 : 


清单 3. 在 ivy.xml 中 定义 依赖 项 


<?xml version-z"1.0" encoding="IS0-8859-1"?> 
<?xml-stylesheet type="text/xsl" hrefz"./config/ivy/ivy-doc.xsl"?» 
<ivy-module version="1.0"> 
<info organisation="com"module="integratebutton" /> 
<dependencies> 
<dependency name="hsqldb" rev="1.8.0.7" /> 
<dependency name="pmd" rev="2.0" /> 
<dependency name="cobertura" rev="1.9"/> 
<dependency name="checkstyle" rev="4.1" /> 
<dependency name="junitperf" rev="1.9.1" /> 
<dependency name="junit" rev="3.8.1" /> 
</dependencies> 
</ivy-module> 


请 注意 ， 清 单 3 未 表示 任何 文件 位 置 或 URL， 人 允许 您 转 到 其 他 目录 位 置 ， 而 无 需 更 改 依赖 项 
列表 。 info 元 素 中 的 organisation 属性 标识 了 组 织 类 型 (如 .net、.org 或 .com) 。 后 接 
module 名 称 。 此 模块 的 依赖 项 列表 遵循 一 种 命名 规范 ， 在 下 一 个 清单 中 您 将 更 清晰 地 看 出 此 
规范 。 目 前 ， 只 需 记 住 dependency name-"cobertura" rev="1.9" 将 转换 为 cobertura-1.9.jar Pp 
可 。 


清单 4 是 |vy 设置 文件 的 示例 。 它 定义 了 清单 3 中 ivy.xml 文件 所 用 的 存储 库 位 置 和 相关 模 
T 


清单 4. Ivy 设置 文件 


«ivysettings» 
«settings defaultResolverz'"chained"/» 
«resolvers» 
«chain name-"chained" returnFirst-"true"- 
«filesystem name-'"libraries"» 
«artifact pattern-"$[ivy.conf.dirj/repository/[artifact]-[revision].[type]" /> 
«/filesystem» 
«url name-"integratebutton"- 
«artifact pattern-"http://www.integratebutton.com/repo/[organisation]/[module]/ 
[revision]/[artifact]-[revision].[ext]" /» 
«/url» 
«ibiblio name-"ibiblio" /» 
«url name-"ibiblio-mirror"- 
«artifact pattern-"http://mirrors.ibiblio.org/pub/mirrors/maven2/[organisation]/ 
[module]/[branch]/[revision]/[branch]-[revision].[ext]" /» 
«/url» 
«/chain» 
«/resolvers» 
«/ivysettings» 








清单 4 中 的 filesystem 元 素 定义 了 本 地 工作 站 上 的 位 置 模式 。 两 个 url 元 素 定 义 了 可 用 于 
FR JAR 文件 的 多 个 位 置 : 第 一 个 元 素 定 义 了 受 我 控制 的 integratebutton.com 上 的 一 个 自 定 

义 存储 库 ; 第 二 个 元 素 定义 了 包含 大 量 开 源 JAR 文件 的 外 部 Maven 存储 库 (不 受 我 控 

制 ) 。 如 果 |vy 无 法 从 第 一 个 存储 库 下 载 一 比如 此 存储 库 宕 机 ， 或 者 文件 未 在 指定 位 置 一 它 
将 尝试 第 二 个 位 置 。 优 点 在 于 ， 一 旦 lvy 下 载 了 一 个 JAR， 它 就 会 将 文件 置 入 您 的 本 地 文件 
系统 ， 不 必 再 为 每 一 次 构建 重新 下 载 这 些 文件 。 


依赖 于 依赖 项 


一 个 模块 常常 要 依赖 其 他 模块 。 例 如 ， 在 图 1 中 可 以 看 到 ，cobertura-1.9.jar 文件 的 多 个 依赖 
项 中 包括 asm-2.2.1.jar > 而 asm-2.2.1 jar 又 依赖 于 asm-tree-2.2.1.jar。 如 果 没 有 像 Ivy 这 样 
的 工具 ， 您 就 需要 确保 类 路 径 中 存在 这 些 JAR 的 正确 版 本 ， 保 证 JAR 版 本 之 间 不 存在 冲突 。 
而 使 用 lvy， 您 只 So cobertura 模块 及 其 所 有 依赖 模块 ， 如 清单 5 中 所 示 的 ivy.xm 文件 
那样 。 切 记 ， 这 个 ivy.xml 文件 与 cobertura-1.9.jar 文件 位 于 同一 目录 。 


清单 5. 在 ivy.xml 文件 中 定义 依赖 项 


<?xml version-z"1.0" encoding-"UTF-8"?» 

«ivy-module version-z"2.0" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:noNamespaceSchemaLocation-"http://ant.apache.org/ivy/schemas/ivy.xsd"» 
«info organisation-"cobertura" module-"cobertura"revisionz"1.9"/» 
«configurations» 

«conf name-"master"/» 
«/configurations» 


«publications» 
«artifact name-"cobertura" type="jar" conf-z'master" /> 
«/publications-» 


«dependencies» 
«dependency org-z"objectweb" name-"asm" revz'"2.2.1" confz'master"/» 
«dependency org-"jakarta" name-"oro" rev-z"2.0.8" conf-z'master"/» 
«dependency org-"apache" name-"log4j" revz"1.2.9" conf-z'master"/» 

«/dependencies» 

«/ivy-module» 


清单 5 中 特别 强调 的 依赖 项 定义 了 objectweb org 和 名 称 asm 以 及 要 使 用 的 特定 修订 版 。|vy 
将 此 信息 与 ivysettings.xml 文件 中 的 存储 库 定义 (如 清单 4 所 示 ) 一 起 使 用 ， 用 于 下 载 JAR 
文件 的 依赖 项 。 

图 2 展示 了 符合 清单 4 所 示 ivysettings.xml 文件 配置 的 存储 库 中 的 目录 结构 : 


图 2. asm 模块 的 目录 结构 


E asm ül 1.5.3 > 3| asm-2.2.1.jar 
Ø asm-attrs > ud 2.2.1 * ivy.xml 
C) asm-tree > 


请 注意 ， 图 2 展示 了 一 个 ivy.xml 文件 〈 见 清单 6) ， 它 定义 了 asm 的 依赖 项 。 在 清单 6 
中 ， 针 对 asm 模块 的 ivy.xml 文件 片段 表示 了 它 惟 一 的 依赖 项 一 asm-tree-2.2.1.jar : 


清单 6. 为 asm 定义 依赖 项 的 ivy.xml 


«dependencies» 
«dependency org-"objectweb" name-"asm-tree"rev-z"2.2.1" conf-z'master"/» 
«/dependencies» 


简单 说 明 一 下 ” cobertura 模块 定义 了 三 个 依赖 模块 : asm ^ jakarta-oro 和 log4j ， 如 清 
单 5 所 示 ? 而 asm 模块 又 有 一 个 依赖 模块 ， 名 为 asm-tree ， 如 清单 6 所 示 9 


请 注意 ， 图 3 中 的 asm-tree 目录 结构 与 图 2 中 的 asm 模块 结构 相似 : 


图 3. asm-tree 模块 的 目 录 结 构 


E asm "| 22.1 习 asm-tree-2.2.1.jar 
|..] asm-attrs > * ivy.xml 
L] asm-tree 


当然 ， 差 别 在 于 JAR 文件 包含 不 同 的 类 ， 图 2 所 示 的 jivyXxml 文件 的 定义 描述 了 asm-tree 模 
块 。 《碰巧 asm-tree 模块 未 在 其 ivy.xml 文件 中 定义 任何 依赖 项 。) 


Ivy 进 阶 
既然 您 已 经 掌握 了 使 用 ly 的 基本 知识 ， 下 面 我 将 介绍 其 他 一 些 有 用 的 Ant 任务 
呈现 报告 


Ivy 提供 了 一 个 任务 ， 用 于 报告 一 个 项 目 中 的 依赖 文件 。 清 单 7 展示 了 如 何 调用 lvy 的 
report Ant 任务 来 创建 依赖 项 列表 : 


清单 7. 通过 Ant 生成 lvy 依赖 项 报告 


<target name="ivy-report" depends="init-ivy"> 
<ivy:report todir="${target.dir}/reports/ivy"/> 
</target> 


清单 7 中 的 脚本 生成 了 一 份 HTML 报告 ， 显 示 了 某 项 目的 依赖 文件 列表 。 图 4 展示 了 该 报 


gw 3h 


图 4. 显示 项 目 依 赖 项 的 HTML 报告 
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其 他 任务 


还 有 其 他 许多 针对 Ivy 的 Ant 任务 可 供 您 使 用 一 通过 为 Maven 生成 一 个 POM 文件 来 清理 本 
地 文件 系统 缓存 。 表 1 显示 了 部 分 lvy 的 Ant 任务 及 其 用 途 : 


表 1. 其 他 [vy Ant 任务 
Task Purpose 
settings 对 于 验证 包含 存储 库 的 主机 最 有 用 
cachepath 履 盖 本 地 文件 系统 上 的 默认 缓存 路 径 ， 所 下 载 的 文件 将 存放 在 此 路 径 中 
repreport 为 存储 库 中 的 几 个 模块 生成 报告 


install 安装 一 个 模块 及 其 所 有 依赖 项 
makepom 通过 ivy.xml 文件 创建 一 个 pom.xmlfile， 供 Maven 使 用 
M ， 强制 在 下 一 次 构建 时 从 存储 库 重新 检索 JAR x 


参见 参考 资料 ， 了 解 lvy 中 可 用 的 其 他 Ant 任务 。 


一 切 视 情况 而 定 


版 本 控制 二 进 制 库 


让 开发 自动 化 : 利用 Ivy 管理 依赖 项 78 


Ivy 并 未 消除 对 JAR 文件 进行 版 本 控制 的 需要 。 我 常常 看 到 有 些 团队 由 于 得 到 了 可 通过 HTTP 
访问 的 存储 库 ， 就 彻底 忘记 了 将 文件 置 于 版 本 控制 系统 之 中 。 如 果 一 年 之 后 您 需要 重新 创建 
软件 ， 而 HTTP. 存储 库 未 得 到 集中 管理 ， 重 新 创建 的 过 程 将 十 分 艰难 。 使 用 可 通过 HTTP 访 
问 的 版 本 控制 存储 库 (如 Subversion) 将 避免 这 样 的 窘境 ， 因 为 您 可 以 集中 管理 并 提供 
HTTP 访问 

Ivy 集中 管理 依赖 文件 ， 消 除了 开发 团队 将 JAR 文件 从 一 个 版 本 控制 存储 库 复制 到 另 一 个 存 
储 库 中 时 可 能 出 现 的 膨胀 现象 。 如 果 您 正 参 与 一 个 简单 的 项 目 ， 将 JAR 文件 签 入 版 本 控制 系 
统 或 使 用 本 文 开头 列 出 的 其 他 某 些 技术 可 能 不 会 显著 降低 您 的 速度 。 但 若 您 的 项 目 规模 越 来 
越 大 ， 或 者 您 在 使 用 公共 文件 的 企业 环境 中 工作 ， 一 种 公共 方法 就 变 得 十 分 人 必要。 无论 是 哪 
种 情况 ，lvy 都 能 使 定义 项 目 依赖 项 更 为 一 致 、 更 为 可 行 。 因 此 值得 您 付出 时 间 研 究 vy 在 您 
的 项 目 中 的 应 用 。 


让 开发 目 动 化 : 目 动 负载 测试 


使 用 Apache Ant 和 Apache JMeter 频繁 进行 负载 测试 


负载 测试 通常 在 开发 周期 的 后 期 执行 ， 但 是 并 不 一 定 要 这 样 。 在 让 开发 自动 化 的 这 一 期 ， 自 
动 化 专家 Paul Duvall 将 向 您 描述 如 何 创建 一 个 运行 JMeter 测试 的 预订 集成 构建 ， 发 现 和 修 
复 开 发 周期 中 出 现 的 问题 。 


您 的 软件 系统 可 供 多 少 用 户 同时 访问 ? 在 不 引起 性 能 下 降 的 前 提 下 可 以 加 载 多 少数 据 ? 您 的 
系统 有 多 大 的 吞吐 量 需 求 ? 间隔 多 久 测 试 一 次 这 些 需求 ? 如 果 您 每 天 至 少 可 以 指定 并 确认 一 
次 这 些 负载 和 性 能 需求 得 到 了 满足 ， 又 会 怎样 ?通过 将 负载 测试 作为 预定 的 自动 构建 的 一 部 
分 来 运行 ， 您 可 以 更 快 地 确定 您 的 系统 在 某 些 负载 条 件 下 的 执行 情况 ， 并 快速 适应 变化 。 


关于 本 系列 


作为 开发 人 员 ， 我 们 的 工作 就 是 为 终端 用 户 实 现 过 程 自动 化 ; 然而 ， 很 多 开发 人 员 却 忽 略 了 
将 自己 的 开发 过 程 自 动 化 的 机 会 。 为 此 ， 我 编写 了 让 开发 自动 化 这 个 系列 的 文章 ， 专 门 探讨 
软件 开发 过 程 自动 化 的 实际 应 用 ， 并 教 您 何 时 以 及 如 何 成 功 地 应 用 自动 化 。 


我 曾经 参与 过 的 一 个 项 目 建立 了 一 组 很 好 的 自动 化 测试 ， 可 以 对 应 用 程序 进行 负载 测试 ， 同 
时 它 还 可 以 运行 多 个 事务 。 问 题 是 ， 这些 测 试 需要 进行 一 些 手动 调节 ， 所 以 开发 团队 无 法 在 
没有 人 工 干 预 的 情况 下 运行 这 些 测试 。 这 限制 了 测试 器 可 用 时 (通常 仅 工 作 几 个 小 时 ) 进行 
测试 的 次 数 。 在 实践 中 ， 测 试 要 隔 好 几 天 才 进 行 一 次 一 间隔 时 间 太 长 ， 无 法 及 时 检测 问题 


在 本 文中 ， 我 将 探讨 如 何 使 用 JMeter 创建 自动 化 测试 、 将 测试 作为 自动 构建 的 一 部 分 运行 ， 
以 及 将 测试 设置 为 每 天 自动 运行 (通常 当 机 器 的 使 用 率 低 时 ) 。 将 测试 作为 预定 构建 的 一 部 
分 运行 可 以 让 您 : 


e 在 任何 时 候 执行 负载 测试 
e 在 开发 过 程 的 初期 检测 并 解决 负载 和 性 能 问题 
监视 构建 服务 器 的 最 新 的 负载 测试 和 性 能 测试 报告 
e 减少 依靠 单个 人 配置 和 运行 测试 时 可 能 出 现 的 瓶颈 和 错误 


i BE 


使 用 JMeter 提升 性 能 


Apache JMeter 是 一 个 开放 源码 项 目 ， 您 可 以 用 来 在 服务 器 上 模拟 重负 载 (C X JMeter 的 更 
多 信息 ， 请 参阅 参考 资料 ) » JMeter 的 文档 集 描述 了 如 何 使 用 它 的 很 多 功能 ， 并 提供 了 大 量 
例子 。 


运行 JMeter 


下 载 并 解压 缩 JMeter ZIP 文件 (请 参阅 参考 资料 获得 下 载 JMeter 的 链接 ) 之 后 ， 使 用 命令 
提示 符 进 入 您 解压 缩 JMeter 的 位 置 ， 并 键入 cd bin 更 改 bin 目录 。 从 bin 目录 键入 
jmeter 打开 JMeter Swing 应 用 程序 ， 如 图 1 所 示 : 


图 1. JMeter GUI 


D BreworyTestPlan. jmx (C: Movibrewery-httpsVestsUoadWireweryTestPlan. jex) - Apache JMeter (2.3.1) 
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创建 测试 计划 


通过 示例 编写 测试 


JMeter 附带 了 很 多 示例 测试 计划 和 脚本 。 不 必 从 头 创建 测试 计划 ， 您 可 以 使 用 docs 目录 中 
的 例子 ， 并 随 着 项 目的 发 展 逐 步 配 置 测 斌 计划。 复杂 之 处 主要 在 于 学 习 编 写 可 以 有 效 模 拟 负 
载 和 性 能 需求 的 负载 测试 。 


您 可 以 使 用 JMeter GUI 创建 测试 计划 。JMeter 中 的 不 同 测试 计划 类 型 包括 : 


e Web 测试 计划 

o 数据 库 测 试 计 划 

e FTP 测试 计划 

e LDAP 测试 计划 

。 扩展 LDAP 测试 计划 
。 Web 服务 测试 计划 
e JMS 点 对 点 测试 计划 
。 JMS 主题 测试 计划 


e 监视 器 测试 计划 
e fnr zs 


每 个 测试 计划 都 以 XML 格式 存储 在 一 个 后 组 名 为 jmx 的 文件 中 。 这 种 非 二 进 制 的 格式 使 以 
后 编辑 计划 更 容易 。 尽 管 您 可 以 通过 以 下 JMeter XML 模式 来 创建 测试 计划 ， 但 是 使 用 GUI 
要 容易 得 多 。 稍 后 您 将 看 到 一 个 例子 ， 该 例子 用 参数 表示 JMeter 的 配置 值 ， 以 自 定 义 测 试 的 


节省 劳力 的 负载 测试 


UA 运行 测试 ， 需 要 一 个 BAN BUT 它们 。 vidi 3 倾 和 知识 Hen , 
JMeter ee 另外 ， 该 测试 每 次 jii di B4 i E UE o 


使 用 Ant 操作 JMeter 测试 


学 习 了 如 何 使 用 GUI 软件 工具 后 ， 我 想 看 看 它 是 否 可 以 从 命令 行 运行 菜 些 实用 工具 ， 这 样 我 
就 不 需要 反复 执行 同样 的 操作 。 例 如 ， 每 次 打开 JMeter 应 用 程序 时 ， 我 喜欢 选择 File > 
Open 来 打开 文件 ， 然 后 运行 一 次 或 多 次 测试 。 我 可 以 为 这 些 组 操作 编写 一 个 脚本 ， 每 次 以 同 
样 的 方式 运行 它们 。 幸 运 的 是 ， 已 经 有 人 编写 了 一 个 Ant 任务 来 为 JMeter 做 这 件 事 : 它 执行 
负载 测试 ， 同 时 提供 了 一 种 传 入 可 选 参数 和 属性 的 方式 。 


示例 构建 脚本 


JMeter 分 区 的 extras 目录 包含 一 个 示例 build.xml 脚本 ， 说 明了 JMeter Ant 任务 的 用 法 。 


在 清单 1 中 ， 我 使 用 Ant 的 taskdef 任务 定义 JMeter 任务 ， 我 将 其 命名 为 jmeter ， 这 样 
我 可 以 在 该 Ant 脚本 的 其 他 地 方 使 用 它 。 要 使 用 该 脚本 ， 您 的 Ant 类 路 径 中 必须 存在 ant- 
jmeterjar 文件 (请 参阅 参考 资料 获得 下 载 链接 ) 。 


清单 1. 在 Ant 中 定义 JMeter 任务 


«taskdef name="jmeter" classname="org.programmerplanet.ant.taskdefs.jmeter.JMeterTask"/> 
:| 


清单 2 中 的 示例 代码 运行 一 个 JMeter 负载 测试 BreweryTestPlan.jmx。 要 运行 某 个 目录 中 的 
所 有 测试 , 只 需 输 入 SmX ? 而 不 是 特定 的 文件 名 °  jmeter 任务 所 需 的 属性 为 

jmeterhome ^ testplan ( S ) 以 及 resultlog 或 resultlogdir ° (清单 2 未 显示 
resultlogdir ， 因为 它 使 用 resultlog ? ) 


清单 2. 从 Ant 运行 JMeter 


«jmeter 

jmeterhomez"$1[jmeter.home]" 
resultlog-"$[basedirj/target/JMeterResults.xml"- 

«testplans dir-"$[basedirj/tests/load" includes-"BreweryTestPlan.jmx"/» 
«/jmeter- 


清单 2 中 的 Ant 代码 创建 了 一 个 名 为 JMeterResults.xml 的 输出 文件 ， 用 于 创建 HTML 报 


使 用 XSLT 呈现 报告 


将 JMeterResults.xml 文件 作为 清单 3 中 的 xslt Ant 任务 的 输入 ， 可 以 为 清单 2 中 运行 的 所 
有 JMeter 测试 生成 一 个 HTML 报告 。 在 JMeter extras 目录 中 提供 的 XSL 样式 表 (jmeter- 
results-detail-report 21.xsl) 用 于 将 JMeterResults 文件 转换 为 HTML ° 


清单 3. 使 用 XSLT 创建 JMeter HTML 报告 


«xslt in="${basedir}/target/JMeterResults.xml" 
out="${basedir}/target/JMeterResults.html" 
style="${jmeter .home}/extras/jmeter-results-detail-report_21.xs1l"/> 


JMeter 也 提供 了 一 个 不 太 详 细 的 XSL 样式 表 文 件 ， 用 于 总 结 负 载 测 试 的 结果 。 


在 HTML 中 显示 报告 


图 2 是 一 个 使 用 清单 3 中 的 xslt 任务 生成 的 HTML 报告 的 例子 。 它 显示 了 每 个 运行 的 负载 
测试 ， 以 及 测试 状态 、 时 间 和 所 有 测试 的 聚合 状态 和 时 间 。 


图 2. 生成 JMeter HTML 报告 
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稍 后 我 将 在 本 文中 向 您 展示 如 何 从 CruiseControl Continuous Integration (CI) 服务 器 (请 参阅 
参考 资料 ) 中 显示 这 


些 报 告 o 


向 JMeter 传递 参数 


根据 您 运行 的 测试 类 型 ， 您 可 能 
式 。 人 例如， 清单 4 展示 了 如 何 增加 JVM 内 存 并 指定 线程 和 循环 的 数量 : 


清单 4. 向 JMeter 传递 可 选 参数 和 属性 


«jmeter 


jmeterhome-"$[jmeter.homej" 
resultlog-"$([basedirj)/target/JMeterResults.xml"» 
«jvmarg value-"-Xincgc"/» 
«jvmarg value-'"-Xmx128m"/» 
«jvmarg value-"-Dproperty-value"/» 
«property name-"request.threads" value="5"/> 
«property name-"request.loop" value-z"50"/-» 
«property name-"jmeter.save.saveservice.assertion results" value-"all'"/» 
«property name-"jmeter.save.saveservice.output format" valuez"xml"/» 
«testplans dir-"$[basedirj/tests/load" includes-"BreweryTestPlan.jmx'/» 
«/jmeter» 


bred 内 置 


考 资料 ) 


在 执行 负载 测试 的 方式 上 ， 使 用 参数 和 属 


o 


的 其 


他 参数 和 属 


想 要 传递 参数 和 属性 ， 以 改变 单个 测试 或 一 组 测试 执行 的 方 


性 来 修改 JMeter 测试 运行 的 方式 (有 关 详 细 人 信息， 请 参阅 


性 提供 了 一 定 的 灵活 性 ， 但 是 它 不 能 解决 如 何在 不 


同 的 目标 环境 中 运行 负载 测试 的 问题 ， 比 如 测试 和 验证 环境 。 要 向 测试 计划 添加 特定 于 环境 
的 信息 ， 您 需要 在 .jmx 文件 中 放 入 一 些 记号 ， 以 便当 负载 测试 在 自动 构建 脚本 中 运行 时 可 以 


对 .jmx 文件 进行 过 滤 和 修改 。 


及 时 负载 测试 


使 用 自动 构建 运行 负载 测试 时 ， 将 其 安排 为 按 某 个 周期 运行 ， 比 如 每 晚 运行 一 次 。 您 可 以 使 
用 CI 或 构建 管理 服务 器 来 实现 。 


安排 CruiseControl 每 天 运行 负载 测试 


使 用 CI 服务 器 的 目的 在 于 ， 只 要 向 项 目的 版 本 控制 存储 库 应 用 了 更 改 ， 就 运行 一 个 自动 构 
建 。 您 也 可 以 将 其 配置 为 按 特定 次 数 运行 构建 。 由 于 负载 测试 通常 需要 较 多 的 计算 资源 ， 在 
这 些 资源 未 被 占用 时 运行 测试 (例如 深夜 或 清早 ) 会 比较 好 。 


人 00) 使 用 CruiseControl Git iq 4 参考 
资料 ) 运行 。 您 可 以 修改 CruiseControl 配置 文件 ， 以 使 用 一 个 特定 的 Ant 目标 运行 一 个 委托 
构建 ， 比 如 一 个 给 定 的 run-1oad-tests 构建 。 


清单 5. 使 用 CruiseControl 运行 预定 的 负载 测试 


«modificationset» 
«svn RepositoryLocationz"$í[svnrepo.locationj"/» 
«timebuild username-"admin" time-z"2300"/» 
«/modificationset» 


通过 将 负载 测试 安排 在 晚上 运行 (如 清单 5 中 一 样 ) ， 您 将 不 会 听 到 有 关 加 班 、 休 假 或 忘记 
运行 We 


在 CruiseControl 中 显示 报告 


您 已 经 看 到 了 如 何 使 用 Ant 显示 JMeter 测试 报告 。 但 是 ，JMeter 报告 只 能 与 单个 机 器 上 的 
一 个 开发 人 员 通 信 。 负 载 测试 会 影响 整个 应 用 程序 ， 所 以 整个 团队 都 会 希望 看 到 结果 。 好 处 
在 于 ， 您 可 以 轻松 配置 您 的 Cl 服务 器 ， 以 显示 这 些 报告 。 因 为 已 经 使 用 Ant 生成 了 这 些 报 
告 ， 所 以 只 需要 使 JMeter HTML 报告 可 以 从 CruiseControl 项 目 仪 表 板 访问 。 您 可 以 向 
CruiseControl 的 config.xml 文件 添加 几 行 代码 来 实现 这 个 目的 ， 如 清单 6 所 示 : 


清单 6. 配置 CruiseControl 来 显示 JMeter 报告 


«project name-"brewery"» 

«log» 

«merge dir-"merge dir-"projects/$[project.namej)/reports/jmeter" /> 
«/1og» 


«/project» 


现在 ， 团 队 中 的 每 个 人 都 可 以 (AEW) 共享 这 些 信 息 了 。 很 多 其 他 CI 和 构建 管理 服务 器 也 
提供 类 似 的 报告 集成 功能 。 


结束 语 


在 本 文中 ， 我 展示 了 如 何 向 您 的 开发 工具 箱 添加 自动 化 负载 测试 。 通 过 使 用 自动 构建 运行 负 
载 测试 ， 然 后 将 测试 安排 为 定期 运行 ， 您 可 以 在 系统 容量 问题 出 现 之 前 及 时 发 现 它们 。 这 种 
方法 使 得 评估 架构 和 数据 更 改 的 影响 变 得 更 加 容易 。 当 与 本 文章 系列 中 描述 的 其 他 技术 结合 
使 用 时 ， 开 发 团队 常常 能 够 交付 更 高 质量 的 软件 。 


下 载 
SES 名 字 大 小 


本 文 的 示例 Ant 脚本 j-ap04088-jmeter-example.zip 6KB 


让 开发 自动 化 : 使 用 自动 化 加 速 部 署 


利用 自动 化 加 速 软 件 在 不 同 环境 间 的 迁移 


自动 化 构建 不 仅仅 适用 于 开发 团队 一 在 将 软件 从 开发 迁移 到 生产 这 一 过 程 中 也 大 有 作为 。 
在 这 一 期 让 开发 自动 化 中 ， 自 动 化 专家 Paul Duvall 将 介绍 如 何 结 合 使 用 Ant 和 
Java™Secure Channel 将 软件 远程 部 署 到 多 个 目标 环境 中 。 


关于 本 系列 


作为 开发 人 员 ， 我 们 的 工作 就 是 为 终端 用 户 实现 过 程 自动 化 ; 然而 ， 很 多 开发 人 员 却 忽略 了 
将 自己 的 开发 过 程 自 动 化 的 机 会 。 为 此 ， 我 编写 了 让 开发 自动 化 这 个 系列 的 文章 ， 专 门 探讨 
软件 开发 过 程 自动 化 的 实际 应 用 ， 并 教 您 何 时 以 及 如 何 成 功 地 应 用 自动 化 。 


您 是 否 曾 注意 到 ， 很 多 团队 总 是 在 将 软件 从 开发 环境 迁移 到 生产 环境 之 后 才 想 到 改善 ? 我 曾 
经 遇 到 过 一 些 团队 ， 他 们 的 开发 周期 长 达 几 个 星期 甚至 几 个 月 不 等 一 我 认为 这 是 浪费 时 间 。 
为 什么 不 像 自 动 化 构建 一 样 ， 通 过 自动 化 大 幅度 减少 花费 在 部 署 配 置 问题 上 的 时 间 ， 并 因此 
提升 基础 架构 的 效率 ? 


仔细 想 一 想 : 软件 部 署 流程 中 的 低 效 率 意 味 着 将 推迟 应 用 程序 到 用 户 的 交付 。 更 糟糕 的 是 ， 
一 些 人 认为 ， 对 于 大 多 数 项 目 ， 部 署 类 似 于 撕 掉 创可贴 〈 仅 会 产生 暂时 的 疼痛 ) ， 然 而 ， 部 
署 问题 将 一 再 滞留 ， 并 且 在 每 次 交付 时 频繁 出 现 。 


除了 延迟 交付 外 ， 低 效 的 部 署 基础 架构 降低 了 团队 对 软件 修改 的 适应 性 ， 这 使 得 他 们 经 常 将 
过 多 的 功能 全 部 填充 到 一 个 版 本 中 (因为 版 本 不 会 经 常 发 布 ) 。 这 导致 了 恶性 循环 : 企业 希 
望 尽快 将 软件 交付 给 用 户 ， 但 是 这 个 流程 太 长 ， 因 此 所 有 人 都 力求 设计 一 个 全 面 的 版 本 (big 
bang) 来 最 大 化 业务 机 遇 。 


实现 无 忧 部 署 


基本 部 署 流程 包括 编译 、 数 据 修 改 集成 (例如 数据 库 表 ) 、 向 其 他 计算 机 远程 部 署 发 行 包 
(如 JAR 和 WAR) ， 以 及 管理 远程 计算 机 中 的 资源 。 尽 管 如 此 ， 仍 然 有 很 多 工作 可 以 通过 
自动 化 完成 ， 比 如 创建 安装 媒体 、 测 试 、 生 成 用 户 文档 等 等 。 在 本 文中 ， 我 将 介绍 这 些 基本 
内 容 并 演示 如 何 将 这 些 流程 纳入 到 自动 化 构建 流程 中 。 具 体 来 说 ， 您 将 了 解 以 下 流程 : 


e 向 远程 机 器 部 署 二 进 制 文件 

e 外 部 化 (externalize) 配置 属性 

。 远程 更 新 MySQL RDBMS 

e 远程 配置 Jakarta 的 Tomcat Servlet 容器 


过 自动 化 实现 这 些 流程 ， 您 能 够 更 迅速 更 顺利 地 向 用 户 交付 软件 。 


必要 工具 


实现 自动 化 部 署 的 核心 工具 是 一 个 构建 脚本 ; 在 本 文中 ， 我 使 用 的 是 Ant。 我 的 Ant 脚本 将 使 
用 属性 文件 (特定 于 目标 环境 ， 如 演示 和 生产 环境 ) ， 通 过 Ant 的 sql Pra MySQL 数据 
库 交 互 ， 使 用 Java Secure Channel (JSch) 将 文件 复制 到 远程 机 器 上 (通过 Secure-Copy 协 
iX (SCP) ) 并 停止 和 启动 Tomcat 服务 (通过 SSH) 。 


图 1 演示 了 这 一 流程 的 高 级 架构 视图 。 关 键 的 一 点 是 ， 所 有 软件 资源 均 存 储 在 一 个 版 本 控 囊 
we 
包 组 件 ， 随 后 远程 执行 SQL 语句 ， 最 后 部 署 发 行 包 并 重新 启动 Tomcat 。 


图 1. 实现 远程 部 署 的 高 级 构建 架构 
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您 可 以 自动 执行 所 有 这 些 流 程 ， 这 样 ， 通 过 执行 一 条 命令 或 单 击 一 下 和 鼠标 就 可 触发 部 署 ， 其 
至 不 需要 人 为 干涉 就 可 对 流程 进行 调度 。 是 不 J 7 


外 部 化 属性 


对 于 不 同 的 目标 环境 ， 配 置 值 (例如 文件 位 置 、 主 机 名 、 数 据 库 名 和 端口 号 ) 可 能 各 不 相 
同 ， 因 此 不 能 进行 硬 编 码 (例如 在 源 代码 中 ) 。 这 些 属性 在 .properties 文 件 中 得 到 了 完善 的 
管理 。 通 过 外 部 化 属性 ， 可 以 使 用 同一 个 构建 脚本 在 一 个 环境 中 编译 ， 然 后 在 另 一 个 环境 中 
部 署 ， 而 不 需要 修改 或 重新 编译 源 代码 。 


属性 规则 


在 转换 到 不 同 环境 时 ， 如 果 需 要 修改 某 个 值 ， 那 么 将 这 个 值 放 到 外 部 的 properties 文件 。 如 
果 构 建 脚本 中 有 多 处 引用 该 值 ， 那 么 应 将 其 转化 为 构建 脚本 ( 即 build.xml) 的 属性 。 如 果 始 
终 只 存在 一 个 引用 ， 就 没有 必要 将 其 转化 为 属性 (但 这 仅仅 是 一 个 假定 条 件 ) 。 


清单 1 演示 了 在 Ant 构建 脚本 中 定义 属性 的 简单 示例 ， 它 允许 您 将 一 个 .properties 文件 作为 
系统 参数 传递 (例如 test.properties ) * 其 中 包含 针对 特定 目标 环境 的 所 有 

值 。 property.file.location 可 解析 为 诸如 C:\Documents 和 
Settings\patrick.henry\test.properties 这 样 的 路 径 。 例 如 ， 您 可 以 在 命令 行 输 

A ant -Dproperty.file.location=C:\Documents and Settings\patrick.henry\test.properties 


o 


清单 1. 外 部 化 property 属性 


«property file-"$[property.file.location)" /> 


清单 2 显示 了 一 个 示例 目标 环境 properties 文件 。 文 件 中 的 values 属 性 在 不 同 目标 环境 中 应 
该 〈 或 者 可 以 ) 是 不 同 的 ， 但 是 names 属 性 则 保持 不 变 。 


清单 2. property 文件 中 的 示例 属性 和 对 应 的 值 


db.database=brewery 

db.username.system-root 

db.password.system-sa 

db.username-root 

db.password-sa 

db.hostnamezmy-hostname.domain.com 
db.driverzcom.mysql.jdbc.Driver 

db.port-3306 
db.url.system-jdbc:mysq1://$[db.hostnamej:$[db.port)/ 
db.url-jdbc:mysq1://$[db.hostnamej:$[db.port)/$(db.database) 


通过 外 部 化 property 属性 和 值 ， 我 们 可 以 创建 一 个 更 加 灵活 的 构建 和 部 署 架 构 ， 从 而 支持 多 
个 目标 环境 。 


以 简单 性 为 核心 


向 另 一 个 环境 部 署 软件 的 流程 不 应 该 过 于 繁杂 ; 应 尽量 保持 简单 ， 就 好 象 输入 "deploy" 一 

样 。 幸 运 的 是 ， 诸 如 Ant 这 样 的 构建 系统 使 这 成 为 了 现实 。 通 过 在 逻辑 上 定义 一 个 工作 流 ， 
按 顺序 执行 一 系列 步 又， 您 可 以 创建 一 个 简单 的 调用 命令 。 

清单 3 的 depends 属性 中 枚 举 的 Ant 目标 从 较 高 层次 定义 了 最 佳 自 动 部 署 流程 。 首 先 ， 脚 本 


从 本 地 环境 中 删除 以 前 生成 的 工件 (使 用 clean 目标 ) 、 编 译 源 代码 、 远 程 创建 数据 库 、 应 
用 测试 数据 、 启 动 数 据 库 ， 最 后 将 WAR 文件 远程 部 署 到 位 于 目标 环境 中 的 Tomcat 容器 中 。 


清单 3. 远程 部 署 中 执行 的 关键 目标 


«target name-z"build" 
depends-"clean, compile, refresh-database, remote-tomcat-deploy" /> 


刷新 数据 库 并 进行 远程 部 署 并 非 易 事 ; 然而 ， 通 过 使 用 一 些 聪明 的 脚本 ， 一 切 都 将 变 得 简 
x! 


自动 化 DBA 


在 设置 目标 测试 环境 时 ， 经 常 需要 执行 一 些 手 动 操作 ， 例 如 配置 数据 库 、 插 入 测试 数据 、 册 
除 昌 条 目 以 及 其 他 重复 性 (并且 容易 出 错 ) 流程 。 幸 运 的 是 ， 在 部 署 期 间 处 理 数 据 库 可 以 变 
得 更 加 简单 。 


Data Definition Language (DDL) 语句 (如 删除 现 有 数据 库 、 创 建 数据 库 和 创建 数据 库 用 
È) 以 及 Data Manipulation (DML) 语句 (如 insert 语句 ) 可 以 轻松 地 脚本 化 并 作为 Ant 
构建 脚本 的 一 部 分 运行 。 而 且 ， 还 可 以 远程 执行 这 些 语句 。 


例如 ， 通 过 从 目标 环境 .properties 文件 传递 一 个 db.url.system 属性 (如 清单 4 所 示 ) ， 构 
建 环境 可 以 针对 一 个 远程 数据 库 执 行 SQL 语句: 


清单 4. 创建 数据 库 和 插入 数据 的 脚本 


«target name-"refresh-database" depends-"create-database,insert-data" /> 

«target namez'"create-database"» 

«sql driverz"$[db.driverj" 
url-"$(db.url.system]" 
userid-"$[db.username.system)" 
passwordz"$(db.password.systemj" 
srcz'"$(database.dirj/create-database.sql"» 
«classpath» 

«pathelement location-"$([mysql-connector.jarj"/» 

«/classpath» 

«/sql» 

</target> 


<target name="insert-data"> 

<sql driver="${db.driver}" 
url="${db.ur1}" 
userid="${db.username}" 
password="${db.password}" 
src="${database.dir}/insert-data.sql"> 
<classpath> 

<pathelement location="${mysql-connector.jar}"/> 

</classpath> 

«/sql» 

</target> 


清单 5 insert-data.sql 文件 的 内 容 是 从 清单 4 的 insert-data 目标 调用 的 。 任 何 SQL i& 
4] > DDL 或 DML， 都 可 通过 Ant 的 sql 任务 以 类 似 方 式 执行 。 


清单 5. 执行 数据 插入 的 SQL i$ 4 


insert into beer(id, beer name, date received) values 
(1, 'Samuel Adams Lager','2006-12-09'); 

insert into beer(id, beer name, date received) values 
(2, 'Guinness Stout','2006-12-29'); 

insert into beer(id, beer name, date received) values 
(3, 'Olde Saratoga Lager','2007-02-14'); 

insert into beer(id, beer name, date received) values 
(4, 'Sierra Nevada Pale Ale','2007-05-14'); 


现在 我 已 经 更 新 了 远程 数据 库 ， 下 一 个 逻辑 步骤 是 向 运行 Tomcat 的 远程 环境 部 署 一 些 资 源 。 


发 行 和 部 着 


远程 部 署 和 本 地 部 署 在 实现 方面 并 非 完全 不 同 ， 它 仅 需要 一 个 不 同 的 通道 ， 从 而 将 资源 安全 
地 从 一 个 位 置 复制 到 另 一 个 位 置 (从 构建 机 器 复制 到 目标 环境 ) 。 在 大 多 数 企业 中 ， 安 全 性 
至 关 重 要 ， 因 此 仅仅 使 用 FTP 和 telnet TONERS 。 在 这 种 情况 下 ，SCP 和 SSH 可 以 
轻松 完成 任务 。 通 过 Ant 可 以 很 方便 地 使 用 这 些 通道 ; 事实 上 ， 我 经 常 使 用 JSch 中 的 
sshexec 和 scp 任务 远程 复制 文件 并 在 远程 机 器 上 运行 命令 。 


迁移 到 生产 环境 


尽管 某 些 软件 应 用 程序 (例如 ，Software as a service， 即 SaaS) 可 以 改变 部 署 频率 ， 但 是 
仍然 难于 迁移 到 生产 环境 中 。 您 需要 添加 应 用 程序 和 数据 库 回 滚 ， 确 保 软 件 系统 能 够 回 滚 到 
以 前 的 状态 。 这 一 点 至 关 重 要 ， 因 为 有 可 能 带 来 数 百 万 美元 的 损失 或 盈利 。 和 测试 软件 系统 
本 身 一 样 ， 必 须 对 自动 化 部 署 流程 进行 严格 测试 。 


使 用 SCP 安全 复制 文件 


SCP 能 够 在 器 之 问安 全 复制 资源 。 很 多 工具 都 支持 SCP。 在 Ant 中， 理论 上 讲 ， 在 
dc d uc te 
为 自动 化 。 


在 清单 6 中 ， scp 任务 (JSch 提供 ) 将 构建 机 器 中 的 WAR 文件 复制 到 远程 机 器 上 。JSch 
Æ (jsch-0.1.36.jar) 必须 位 于 Ant 的 类 路 径 中 ， 以 利用 scp 任务 


清单 6. 将 一 个 WAR 文件 从 一 个 机 器 中 安全 复制 到 另 一 个 机 器 


«target namez"copy-tomcat-dist'» 

«scp file-'"$([basedir)/target/brewery.war" 

trust-"true" 

keyfile-'$[ssh.key.filej" 

username-"$[ssh.username]" 

passphrasez"" 
todir-"$[ssh.server.username):$[ssh.server.password)O0$(ssh.server.hostnamej 
:$(tomcat.home)/webapps" /> 
</target> 


当 调 用 scp 任务 时 ， 需 要 提供 进行 复制 的 本 地 文件 的 位 置 ， 以 及 本 地 SSH 私 钥 文件 的 位 置 
(清单 6 中 的 ssh.key.file ， 用 于 安全 身份 验证 ) 。 最 后 ， 需 要 在 远程 机 器 上 提供 一 个 位 置 
(清单 6 中 的 ssh.server.hostname ) > scp 将 把 (一 个 或 多 个 ) 本 地 文件 放 在 这 个 位 置 。 


使 用 SSH 远程 调用 流程 


与 使 用 SCP 一 样 ， 在 远程 机 器 上 运行 命 需要 某 种 安全 机 制 ， 例 如 SSH。 在 清单 7 
中 ， 我 使 用 JSch sshexec Ant Po ie dd Mu. 元 程 机 器 上 的 Tomcat 容器 。 构 
建 流程 刚刚 将 一 系列 资源 (如 WAR x £F) 复制 到 这 台 机 器 上 。 


清单 7. 停止 和 重新 启动 远程 Tomcat 实例 


«target name="remote-tomcat-stop> 
«sshexec host="${ssh.hostname}" 
port="${ssh.port}" 
keyfile="${ssh.key.file}" 
username="${ssh.username}" 
passphrasez"" 
trust-"true" 
command-"$[tomcat.homej/bin/shutdown" /> 
«sleep seconds-"$[sleep.timej" /> 

</target> 


<target name="remote-tomcat-start"> 
<sshexec host="${ssh.hostname}" 
port="${ssh.port}" 
username="${ssh.username}" 
passphrase="" 

trust="true" 

keyfile="${ssh.key.file}" 
command="${tomcat .home}/bin/startup" /> 
<sleep seconds="${sleep.time}" /> 
</target> 


在 清单 7 中 ， 我 提供 了 托管 Tomcat 的 机 器 的 名 称 ，Tomcat 的 端口 号 (通常 为 8080) ^ 44 
文件 ( ssh.key.file ) ， 这 样 ， 构 建 脚本 可 以 安全 地 访问 这 个 机 器 并 执行 特定 命令 。 在 本 例 
中 ， 可 以 看 到 ， 我 依次 调用 了 shutdown 和 startup 名 命令 。 


理论 上 讲 ， 完 成 这 一 步骤 后 ， 我 已 经 完成 了 下 面 这 些 任 务 : 配置 远程 数据 库 、 将 一 个 Web 应 
用 程序 移 至 远程 计算 机 、 运 行 一 个 Tomcat 实例 。 至 此 ， 人 们 可 以 正常 测试 甚至 使 用 新 版 本 的 
应 用 程序 。 


结束 语 


希望 本 文 已 经 向 您 展示 了 如 何 轻 松 实现 自动 化 部 署 流程 。 将 软件 从 开发 环境 中 交付 到 用 户 手 
中 不 能 (或 不 应 该 ) 是 一 个 手动 流程 ， 也 不 需要 将 它 从 开发 团队 的 构建 流程 明确 分 离 出 来 。 
实际 上 ， 通 过 本 文 介绍 的 方法 ， 软 件 发 行 可 以 像 按 下 某 个 按钮 一 样 简单 ， 当 然 ， 这 必然 会 显 
著 提 高 开发 团队 频繁 交付 特性 的 能 力 。 


让 开发 自动 化 : 持续 集成 反 模 式 


通过 避免 反 模 式 轻 松 实 现 持 续集 成 


尽管 持续 集成 (Continuous Integration > CI) 可 以 非常 有 效 地 减少 项 目的 风险 ， 但 是 它 对 与 
编程 相关 的 日 常 活动 提出 了 很 高 的 要 求 。 在 这 一 期 让 开发 自动 化 中 ， 自 动 化 专家 和 
Continuous Integration: Improving Software Quality and Reducing Risk 的 作者 之 一 Paul 
Duvall 列举 了 一 系列 CI 反 模 式 并 解释 了 如 何 避 免 它们 。 


在 我 的 职业 生涯 中 经 常 发 现 ， 通 过 了 解 在 特定 情况 下 不 应 该 做 什么 ， 可 以 学 到 更 多 知识 。 例 
如 ， 在 我 职业 生涯 的 早期 ， 由 于 需要 快速 发 布 软件 ， 我 省 略 了 单元 测试 ， 因 为 我 认为 不 值得 
做 这 些 工作 。 幸 运 的 是 ， 我 已 经 学 到 绝 不 应 该 将 未 经 测试 的 代码 投入 生产 ; 因此 开始 坚持 纺 
写 单元 测试 。 


整个 IT 行业 似乎 都 主要 采用 这 种 学 习 方 式 ; 实际 上 ， 我 们 甚至 专门 创建 了 反 模 式 (anti- 
pattern) 这 个 词 ， 表 示 在 特定 环境 中 不 应 该 采用 的 做 法 。 反 模式 是 看 起 来 似乎 有 好 处 ， 但 是 
最 终 可 能 产生 严重 影响 的 解决 方案 。 


看 似 上 真实 的 假象 


遗憾 的 是 ， 我 发 现 当 缺少 经 验 的 团队 试图 采用 CI 时 ， 他 们 很 可 能 错误 地 采用 许多 反 模 式 ， 这 
最 终 导 致 他 们 不 但 没有 获得 预期 的 好 处 ， 反 而 遇 到 一 大 堆 麻烦 。 不 幸 的 是 ， 在 这 种 情况 下 ， 
团队 常常 将 麻烦 归罪 于 Cl 本 身 。 因 此 ， 我 常常 听 到 “Cl 不 适合 大 项 目 ” 或 “我 们 的 项 目 太 特 
殊 ， 不 适合 采用 CP 这 样 的 说 法 ， 实 际 上 CI 根本 不 是 问题 的 原因 一 是 某 些 做 法 的 不 恰当 应 用 
或 者 缺少 某 些 方法 导致 了 这 些 麻烦 。 


关于 本 系列 


作为 开发 人 人员， 我 们 的 工作 就 是 为 终端 用 户 实现 过 程 自 动 化 ; 然而 ， 很 多 开发 人 员 却 忽略 了 
将 自己 的 开发 过 程 自动 化 的 机 会 。 为 此 ， 我 编写 了 让 开发 自动 化 这 个 系列 的 文章 ， 专 门 探讨 
软件 开发 过 程 自动 化 的 实际 应 用 ， 并 教 您 何 时 以 及 如 何 成 功 地 应 用 自动 化 。 


在 本 文中 ， 我 要 描述 与 C| 相关 的 六 个 反 模 式 : 


e 签 入 不 够 频繁 ， 这 会 导致 集成 被 延迟 

e 破碎 的 构建 ， 这 使 团队 无 法 转 而 执行 其 他 任务 
e 反馈 太 少 ， 这 使 开发 人 员 无 法 采取 纠正 措施 
e 接收 垃圾 反馈 ， 这 使 开发 人 员 和 忽视 反馈 消息 
e 所 拥有 的 机 器 缓慢 ， 这 导致 延迟 反馈 

e 依赖 于 膨胀 的 构建 ， 这 会 降低 反馈 速度 


如 果 您 采用 CI 的 时 间 足 够 长 ， 那 么 几乎 肯定 体验 过 这 些 反 模式 的 效果 。 这 没关系 ， 但 是 如 果 
它们 发 生得 太 频 繁 ， 就 会 大 大 限制 CI 的 好 处 。 因 此 ， 如 果 您 希望 避免 这 些 反 模式 并 控制 它们 
的 负面 影响 ， 那 么 本 文正 适合 您 。 


由 于 签 入 不 够 频繁 导致 的 延迟 集成 
名 称 : 签 入 不 够 频繁 

反 模 式 : 由 于 所 需 的 修改 太 多 ， 源 代码 长 时 间 签 出 存储 库 。 
解决 方案 : 频繁 地 提交 比较 小 的 代码 块 。 


实施 CI 的 前 提 是 团队 可 以 快速 获得 关于 当前 开发 的 代码 的 反馈 ; 而 且 ， 与 传统 的 集成 相 比 ， 
这 种 频繁 的 软件 集成 风格 会 减少 集成 花费 的 时 间 (和 麻烦 ) 。 但 是 ， 有 效 的 CI 假设 修改 会 频 
繁 地 发 生 (所 以 可 以 频繁 地 执行 构建 ! ) 。 如 果 代码 长 期 留 在 开发 人 员 的 桌面 (而 不 是 存储 
E) 中 ， 那 么 就 会 出 现 粮 糕 的 情况 ， 因 为 在 系统 的 不 同 部 分 中 会 出 现 其 他 修改 。 


每 天 提交 一 次 ， 成 功 实现 集成 


一 条 常用 的 经 验 规则 是 至 少 每 天 签 入 一 次 代码 。 我 使 用 一 种 有 效 的 技术 : 如 果 我 觉得 需要 把 
工作 停 一 下 ， 就 会 先 看 看 目前 是 否 可 以 运行 本 地 构建 ， 然 后 提交 代码 。 然 后 我 才 会 暂停 工 
作 。 


从 本 质 上 说 ， 如 果 不 频繁 地 提交 修改 ， 集 成 就 会 延迟 ; 延迟 越 长 ， 消 除 其 严重 影响 就 越 困难 
(比如 其 他 人 的 修改 可 能 会 影响 您 的 代码 ) o 对 于 使 用 CI 的 项 目 ， 我 建议 开发 人 员 至 少 每 天 
签 入 一 次 代码 ， 但 是 我 相信 最 好 是 每 天 签 入 多 次 。 


任务 越 小 ， 工 作 越 轻松 


我 常常 听 到 一 些 开 发 人 员 抱 她 说 ， 他 们 要 忙于 修改 那么 多 文件 ， 哪 有 精力 每 天 签 入 代码 。 实 
际 上 ， 这 正 是 我 要 说 的 要 点 一 为 了 每 天 提交 源 代码 修改 ， 需 要 将 任务 划分 得 更 小 。 实 际 上 ， 
需要 将 编程 任务 划分 成 小 块 ， 这 样 修改 也 会 更 小 。 


不 要 在 一 个 大 任务 中 实现 一 个 业务 对 象 上 的 所 有 特性 ， 例 如 编写 

read() ^ write() ^ update() 和 delete() 方法 的 原型 ; 而 是 应 该 首先 编写 read() 方法 
(以 及 对 应 的 测试 ) ， 然 后 签 入 这 个 类 ， 从 而 与 整个 代码 基 集 成 。 接 下 来 ， 可 以 实现 另 一 个 
方法 ， 再 次 执行 签 入 ， 直 到 完成 整个 任务 。 这 样 的 话 ， 就 可 以 让 CI 的 好 处 最 大 化 ， 而 且 会 让 
您 确信 自己 的 代码 可 以 与 别人 的 代码 相互 配合 。 


请 记 住 ， 即 使 您 和 您 的 团队 正确 地 执行 许多 CI 实践 ， 如 果 团 队 成 员 不 坚持 至 少 每 天 签 入 一 次 
源 代 码 修 改 ， 那 么 CI 的 好 处 会 大 打折 扣 。 这 常常 会 让 人 误 以 为 Cl 是 无 效 的 ， 这 种 想法 实在 
大 错 特 错 。 


破碎 的 构建 减 慢 了 开发 的 节奏 


名 称 : 破碎 的 构建 
反 模 式 : 构建 长 时 间 破 碎 ， 导 致 开发 人 员 无 法 签 出 可 运行 的 代码 。 
解决 方案 : 在 构建 破碎 时 立即 通知 开发 人 员 ， 并 以 最 高 优先 级 尽快 修复 破碎 的 构建 。 


无 论 您 信 不 信 ， 构 建 破 碎 的 时 间 越 长 ， 就 越 麻 烦 。 这 是 因为 文件 、 修 改 和 依赖 项 越 多 ， 隔 离 
缺陷 就 越 困 难 。 因 此 ， 当 通知 某 人 构建 破碎 时 〈 通 过 电子 邮件 、RSS 或 其 他 机 制 ) ， 他 应 该 
优先 解决 这 个 问题 ; 否则 ， 构 建 破 碎 的 时 间 越 长 (尤其 是 对 于 频繁 修改 代码 的 团队 ) ， 就 越 
难 纠正 。 


破碎 的 构建 不 总 是 坏事 。 实 际 上 ， 和 破碎 的 构建 会 让 您 迅速 地 意识 到 软件 出 了 问题 。 当 构建 频 
繁 地 破碎 或 长 时 间 破 碎 时 ， 破 碎 的 构建 就 会 成 为 问题 。 在 构建 破碎 的 情况 下 ， 绝 不 应 该 置 之 
TH e 


不 存在 永 不 破碎 的 构建 


ARCA ce > “KARR RAJE pU A EARE o GUI E RE 
免 许 多 常见 的 构建 错误 ， 比 如 缺少 文件 或 破碎 的 测试 ; ES , ur a 
问题 。 构 建 可 能 只 做 少量 工作 (可 能 只 是 执行 一 个 编译 和 几 个 单元 测试 ) 。 我 称 之 为 “持续 忽 
视 (Continuous Ignorance) ”， 这 种 情况 有 时 候 比 频繁 的 破碎 构建 更 糟糕 。 


用 私有 构建 减少 破碎 的 构建 


防止 破碎 构建 的 有 效 技 术 之 一 是 ， 在 将 代码 提交 到 存储 库 之 前 ， 运 行 私有 构建 (private 
build) 。 执 行 私有 构建 的 步骤 如 下 


从 存储 库 签 出 代码 。 

在 本 地 修改 代码 。 

用 存储 库 执 行 更 新 ， 从 而 集成 其 他 开发 人 员 所 做 的 修改 。 
运行 本 地 构建 。 

构建 成 功 之 后 ， 将 修改 提交 到 存储 库 。 


coo RONvc- 


图 1 说 明了 这 种 做 法 。 注 意 ， 这 个 工作 流 强 调频 繁 地 与 存储 库 执行 同步 ， 从 而 保证 定期 签 入 
并 限制 破碎 的 构建 LEGE TR E ! 


图 1. 运行 私有 构建 减少 破碎 的 集成 构建 
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通过 在 签 入 源 代 码 之 前 执行 私有 构建 (当然 是 频繁 地 执行 ) ， 可 以 避免 许多 导致 构建 破碎 的 
典型 错误 ; 因此 ， 可 以 节省 时 间 和 减少 麻烦 。 


由 于 反馈 太 少 ， 无 法 示 取 纠正 措施 


名 称 : 反馈 太 少 
反 模 式 : 团队 没有 把 构建 状态 通知 发 送 给 团队 成 员 ; 因此 ， 开 发 人 员 不 知道 构建 已 失败 。 
解决 方案 : 使 用 各 种 反馈 机 制 传播 构建 状态 信息 。 


在 设置 C| 系统 时 ， 团 队 常常 认为 接收 电子 邮件 是 浪费 时 间 ; 因此 ， 他 们 决定 不 发 布 通知 。 但 
是 ， 如 果 没 有 对 构建 的 反馈 ， 就 无 法 采取 纠正 措施 。 实 际 上 ， 反 馈 是 CI 最 重要 的 方面 之 一 ; 
因此 ， 反 馈 是 否 有 效 也 非常 关键 。 


如 果 希 望 扩展 将 构建 状态 信息 发 布 给 团队 成 员 的 机 制 ， 那 么 使 用 视觉 和 声音 设备 可 能 很 有 帮 
助 ， 对 于 集中 工作 的 团队 尤其 如 此 。Ambient Orb 这 样 的 设备 可 以 几乎 实时 地 反映 构建 的 状 
态 。 例 如 ， 当 构建 失败 时 ， 可 以 显示 红色 ; 当 构 建 通过 时 ，orb 显示 绿色 。 另 外 ，orb 还 
可 以 传播 其 他 信息 ， 例 如 通过 改变 颜色 表示 代码 库 的 复杂 性 是 增长 还 是 下 降 (比如 绿色 表示 
良好 ， 黄 色 表 示 糟 糕 ) 。 


发 挥 创造 力 


设置 Ambient Orb 非常 容易 。 清 单 1 演示 如 何 使 用 Quality Lab 的 开放 源码 软件 orbrask 在 
Ant 中 设置 Ambient Orb : 


清单 1. 使 用 Ambient Orb Ant 任务 


«target name-"notifyOrb" > 
«taskdef classname-"org.qualitylabs.ambientorb.ant.OrbTask" 

name-"orb" classpathref-"orb.class.path"/» 

«orb queryz'http://myambient.com:8080/java/my devices/submitdata.jsp" 
deviceId-"AAA-9A9-AA9" 
colorPass-"green" 
colorFail-"red" 
commentFail-'"Code-Duplication-Threshold*Exceeded" /> 

«/target» 


清单 1 中 的 任务 对 于 通过 状态 将 orb 改 为 绿色 ， 对 于 失败 状态 显示 红色 。 图 2 显示 绿色 的 
orb， 这 表示 最 近 的 构建 状态 是 成 功 : 


图 2. 成 功 的 构建 ! 





团队 可 以 创造 性 地 使 用 各 种 反馈 机 制 ， 让 团队 成 员 不 会 忽视 构建 状态 消息 。 另 外 ， 这 些 技术 
也 会 让 CI 变 得 生动 有 趣 ， 让 人 们 更 容易 注意 到 需要 采取 措施 的 问题 。 


其 他 通知 机 制 包括 


e RSS feed 

e 任务 栏 监视 器 ， 比 如 CCTray (用 于 CruiseControl) 
e X10 设备 M LavaLamps) 

e 通过 Jabber 等 发 送 的 即时 消息 

SMS (Text Messages ) 


警告 : 需要 在 信息 过 多 和 信息 过 人 该 随 着 工作 环境 定期 调 
整 。 例 如 ， 对 于 集中 工作 的 团队 ， 声 音 提示 可 能 是 有 效 的 (比如 在 构建 失败 时 发 出 火灾 警 
报 ) ;但 是 ， 其 他 团队 可 能 更 喜欢 Ambient Orb ( 它 不 会 在 您 陷入 沉思 时 吓 着 您 ) 。 


垃圾 反馈 


名 称 : 垃圾 反馈 


反 模 式 : 团队 成 员 很 快 被 构建 状态 消息 淹没 (成 功 、 失 败 或 界 于 这 两 者 之 间 的 各 种 消息 ) ， 
所 以 开始 忽视 这 些 消息 。 


解决 方案 : 反馈 要 目标 明确 ， 使 人 们 不 会 收 到 无 关 的 信息 。 


与 “反馈 太 少 ” 反 模 式 相 反 ， 我 常常 发 现 团 队 天 丨 地 认为 ， 当 Cl 服务 器 做 任何 事情 时 ， 每 个 人 
都 应 该 接 到 反馈 (比如 电子 邮件 ) 。 信 息 一 旦 泛滥 ， 人 们 就 会 忽视 它们 ; 如 果 反 馈 太 多 ， 团 
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可 能 无 法 引起 注意 。 


过 精确 地 确定 反馈 的 目标 ， 尽 可 能 减少 垃圾 反馈 


清单 2 给 出 一 个 CruiseControl 配置 文件 示例 ， 演 示 如 何 有 效 地 使 用 电子 邮件 通知 。 在 这 个 示 
例 中 ， 无 论 构建 是 成 功 还 是 失败 ， 技 术 主 管 都 会 收 到 电子 邮件 ， 项 目 经 理 只 在 构建 失败 时 收 
到 电子 邮件 ， 最 近 向 存储 库 提 交 源 代码 修改 的 开发 人 员 也 会 收 到 通知 。 


清单 2. 使 用 CruiseControl 发 送 电 子 邮 件 通 


«project name="brewery"> 


«publishers» 

«htmlemail 
cssz",./webapps/cruisecontrol/css/cruisecontrol.css" 
mailhost-"localhost" 
xsldirz"./webapps/cruisecontrol/xsl" 
returnaddress-z"cruisecontrolQlocalhost" 
buildresultsurl-"http://localhost:8080" 
mailport-"25" 
defaultsuffix-"Qlocalhost" spamwhilebroken-z"false"» 
«always address-"techleadQlocalhost"/» 

«failure address-"pmQlocalhost" reportWwhenFixed-"true"/» 

«/htmlemail» 

«/publishers» 


反馈 是 C| 系统 最 重要 的 方面 之 一 ， 值 得 好 好 讨论 一 下 。 反 馈 太 少 和 垃圾 反馈 是 两 个 极端 要 
在 它们 之 间 找 到 一 个 适当 的 平衡 点 。 当 构建 破碎 时 ， 必 须 及 时 地 将 反馈 发 送 给 适当 的 人 ， 而 
且 必 须 提 供 采取 纠正 措施 所 需 的 信息 。 如 果 构 建 是 成 功 的 ， 那 么 应 该 只 向 少数 人 发 送 反 馈 ， 


包括 最 近 提 交 修 改 的 开发 人 员 以 及 希望 掌握 最 新 情况 的 技术 领导 。 如 果 不 加 区 分 地 把 所 有 状 
态 消息 发 送 给 所 有 人 ， 肯 定 会 大 大 损害 Cl 过 程 的 效果 。 


不 要 让 缓慢 的 机 器 导致 反馈 延 


名 称 : 缓慢 的 机 器 

反 模 式 : 用 一 台 资 源 有 限 的 工作 站 执行 构建 ， 导 致 构建 时 间 太 长 。 

解决 方案 : 增加 构建 机 器 的 磁盘 速度 、 处 理 器 和 RAM 资源 ， 从 而 提高 构建 速度 。 

几 年 前 ， 我 参与 了 一 个 相当 大 的 项 目 ， 它 有 超过 一 百 万 行 代码 ， 编 译 需 要 花 两 个 小 时 以 上 。 
当 我 们 试图 更 频繁 地 执行 集成 时 ， 等 待 持续 管理 团队 执行 集成 的 时 间 越 来 越 长 ， 让 人 很 不 耐 
烦 。 当 然 ， 两 个 小 时 其 实 是 最 好 的 情况 ， 因 为 构建 常常 失败 ， 所 以 这 个 过 程 常 常 要 花 几 天 

(AAEH!) 。 这 种 情况 持续 几 周 之 后 ， 解 决 方案 就 非常 明确 了 : 必须 购买 一 台 更 强大 
的 机 器 ， 它 的 磁盘 空间 必须 足以 容纳 所 有 要 签 出 的 文件 和 构建 生成 的 文件 ， 它 的 处 理 器 速度 

更 快 ， 可 以 处 理 许多 指令 ，RAM 数量 要 足以 运行 测试 和 其 他 需要 大 量 内 存 的 进程 。 


您 觉得 需要 提高 速度 吗 ? 


有 了 这 人 台 强 大 的 机 器 ， 我 们 将 构建 时 间 从 两 个 小 时 降低 到 了 30 分 钟 ; 所 以 ， 通 过 花费 额外 资 
金 购买 最 新 的 机 器 ， 我 们 节省 了 大 量 时 间 和 人 金钱， 而 且 最 终 能 够 更 快 地 集成 软件 文 意味 着 
更 快 地 发 现 问题 | ) o 

用 更 强大 的 工作 站 执行 集成 构建 总 是 没 错 的 ; 但 是 ， 这 个 故事 的 要 旨 在 于 ， 如 果 发 现 构 建 机 
S ate cl tne de E 进行 升级 ; 加 快 构建 可 以 帮助 我 
们 更 快 地 获得 反馈 ， 快 速 纠 正 问题 ， 更 快 地 转 到 下 一 个 开发 任务 


膨胀 的 构建 导致 反馈 延 


名 称 : 膨胀 的 构建 

反 模 式 : 把 太 多 的 任务 添加 到 提交 构建 过 程 中 ， 比 如 运行 各 种 自动 检查 工具 或 运行 负载 测 
试 ， 从 而 导致 反馈 被 延迟 。 

解决 方案 : 一 个 构建 Eğ (pipeline) 可 以 运行 不 同类 型 的 构建 。 


一 些 开 发 团队 喜欢 把 能 添加 的 所 有 过 程 都 添加 到 自动 构建 中 ， 但 是 他 们 忘 了 执行 这 些 操作 是 
要 花 时 间 的 。 还 记得 吗 ? 我 遇 到 的 那个 项 目的 编译 要 花 两 个 小 时 。 想 像 一 下 ， 如 果 把 执行 测 
试 添加 到 构建 过 程 中 ， 会 怎么 样 呢 ? 对 于 一 百 万 行 代码 ， 您 认为 运行 静态 分 析 工 具 要 花 多 长 


时 间 ? 如 果 您 认为 耗 时 八 小 时 的 构建 过 程 是 难以 令 人 置信 的 ， 那 么 再 想 想 吧 。 我 经 常 遇 到 这 
种 情况 。 


为 了 向 团队 成 员 提供 更 多 的 构建 信息 ， 团 队 往 往 会 逐渐 增加 构建 过 程 的 内 容 。 要 向 开发 团队 
提供 快速 反馈 ， 还 要 从 Cl 构建 过 程 提供 有 用 的 信息 ， 必 须 在 这 两 个 目标 之 间 取 得 平衡 。 


通过 构建 管道 提高 效率 


如 果 发 现 构 建 过 程 耗 时 太 长 ， 而 且 已 经 实现 了 其 他 改进 技术 (比如 改 用 更 快 的 机 器 ) 并 优化 

了 测试 执行 时 间 ， 那 么 就 有 必要 考虑 创建 所 谓 的 构建 管道 (build pipeline) 。 构 建 管道 的 用 
途 是 异步 地 执行 长 时 间 运 行 的 过 程 ， 这 样 的 话 ， 开 发 人 员 答 入 代码 之 后 ， 不 需要 长 时 间 等待 
反馈 。 


例如 ， 如 果 执 行 一 个 构建 过 程 要 花 10 分 钟 以 上 ， 那 么 可 以 创建 一 个 构建 管道 ， 在 某 人 将 代码 
提交 到 存储 库 之 后 ， 它 会 运行 一 个 初步 的 轻型 构建 。 这 个 “提交 ”构建 由 编译 和 运行 快速 单元 
测试 等 轻型 过 程 组 成 。 如 果 这 个 初步 构建 成 功 了 ， 就 可 以 运行 第 二 个 构建 ， 它 执行 长 时 间 运 

行 的 测试 、 软 件 检 查 ， 甚 至 包括 部 署 到 应 用 服务 器 上 。 


例如 ， 在 清单 3 中 ， 让 CruiseControl 检查 存储 库 中 的 修改 。 当 发 现 修改 时 ，CruiseControl 
运行 一 个 所 谓 的 委派 (delegating) 构建 ， 它 调用 项 目 站 (在 使 用 Ant 时 是 
build.xml) 。 人 但是， 特殊 之 处 是 CruiseControl 执行 另 一 个 目标 ， 这 个 目标 执行 一 些 轻 型 过 
程 ， 比 如 编译 和 细 粒 度 的 单元 测试 。 


清单 3. 检查 修改 的 CruiseControl 配置 


«project name="brewery-commit"> 
«modificationset quietperiod-z"120"» 


«svn RepositoryLocation-"http://brewery-ci.googlecode.com/svn/trunk"/» 
«/modificationset 


在 清单 4 F > CruiseControl 检查 对 brewery-commit 项 目的 修改 〈 这 个 项 目 TINY — 
它 实际 上 查看 一 个 日 志文 件 ) 。 当 发 现 修改 时 ， rai 运行 另 一 个 委派 构建 。 这 个 构 
建 调 用 相同 的 构建 文件 ， 但 是 执行 另 一 个 目标 。 这 个 目标 可 能 执行 长 时 间 运 行 的 过 程 ， 比 如 
功能 测试 、 软 件 检查 等 等 。 


清单 4. 执行 长 时 间 和 运行 的 构建 的 CruiseControl 配置 


«project name="brewery-secondary"> 


«modificationset quietperiod="120"> 
«buildstatus logdir-"logs/brewery-commit"/-» 
«/modificationset» 


膨胀 的 构建 反 模 式 是 导致 C| 无 法 实施 的 最 常见 原因 。 但 是 ， 正 如 您 看 到 的 ， 使 用 构建 管道 可 
以 避免 这 种 情况 。 有 效 的 构建 管道 应 该 充分 利用 “80/20” 规则 : 百 分 之 20 的 构建 时 间 花 费 在 
导致 百 分 之 80 的 构建 错误 (比如 缺少 文件 、 破 碎 的 编译 和 测试 失败 ) 的 部 分 上 。 完 成 这 个 过 
程 之 后 ， 开 发 人 员 接 到 反馈 ， 然 后 运行 第 二 个 构建 过 程 ， 这 个 过 程 的 运行 时 间 比 较 长 ， 但 是 
只 产生 百 分 之 20 的 构建 错误 。 


反 模 式 是 可 以 纠正 的 


CI 反 模 式 会 妨碍 团队 从 持续 集成 实践 中 获得 最 大 的 收益 ; 但 是 ， 本 文 描述 的 技术 有 助 于 限制 
这 些 反 模式 发 生 的 频率 。 这 些 技术 包括 : 


。 经 常 提 交代 码 ， 可 以 防止 集成 变 得 复杂 。 
e 在 提交 源 代 码 之 前 运行 私有 构建 ， 可 以 避免 许多 破碎 的 构建 。 
e 使 用 各 种 反馈 机 制 避免 开发 人 员 忽视 构建 状态 信息 。 
e 有 针对 性 地 向 可 以 采取 措施 的 人 发 送 反 馈 ， 这 是 将 构建 问题 通知 团队 成 员 的 好 方法 。 
e 花费 额外 资金 购买 更 强大 的 构建 机 器 ， 从 而 加 快 向 团队 成 员 提供 反馈 的 速度 。 
e 创建 构建 管道 来 缓解 构建 膨胀 。 
本 文 描述 了 我 最 常 遇 到 的 一 些 反 模式 ， 但 是 还 有 其 他 反 模 式 ， 包 括 : 
e 持续 忽视 (Continuous Ignorance) ， 也 就 是 构建 过 程 只 包含 很 少 的 过 程 ， 导 致 构建 总 
是 成 功 。 
e 构建 只 在 您 的 机 器 上 执行 ， 这 会 延长 引入 缺陷 和 纠正 缺陷 之 间 的 时 间 。 
e 瓶颈 提交 (Bottleneck Commits) ， 这 会 导致 破碎 的 构建 ， 让 团队 成 员 无 法 回 家 。 
e 运行 间歇 构建 (intermittent build) ， 这 使 反馈 延迟 。 


明年 我 会 讨论 其 他 影响 持续 集成 效果 的 CI 反 模 式 ， 请 保持 关注 。 


让 开发 自动 化 : 断言 架构 可 靠 性 


通过 主动 构建 过 程 掌控 架构 

您 的 软件 架构 和 您 所 期 望 的 一 样 吗 ? 当 架 构 落实 到 代码 时 ， 它 并 不 总 是 我 们 曾经 互相 讨论 并 
预想 的 那个 。 在 本 期 的 让 开发 自动 化 中 ，Paul Duvall 将 演示 如 何 通 过 使 用 JUnit、JDepend 
fe Ant 编写 有 关 测 试 来 发 现 架 构 偏 差 ， 从 而 做 到 在 发 生 问 题 之 前 主动 发 现 问 题 。 

我 在 曾经 从 事 的 很 多 软件 开发 项 目 中 观察 到 ， 和 软件 开发 中 一 直 存 在 这 样 一 种 现象 : 您 实际 拥 
有 的 架构 往往 与 想象 中 的 不 同 。 

通过 分 析 代 码 的 度量 报告 ， 比 如 由 JDepend (参阅 Resources) 工具 生成 的 报告 ， 您 可 以 有 
效 地 判定 代码 是 否 实现 了 确定 的 架构 。 有 些 团队 对 代码 做 反 向 设计 ， 得 到 对 应 的 UML 图 表 ， 
也 能 够 达到 上 述 效 果 ， 还 有 一 些 团 队 甚 至 在 编程 时 使 用 IDE 生成 相同 的 工件 一 一 即 实时 反 
向 设计 。 可 是 ， 所 有 的 这 些 方法 都 还 是 反应 式 (reactive) 的 。 您 必须 手工 审视 并 分 析 报 告 
或 图 表 ， 确 定 架 构 是 否 存 在 偏离 ， 而 有 时 这 种 偏离 可 能 很 久之 后 才 被 发 现 。 

设想 每 当 某 部 分 代码 与 期 望 的 架构 有 所 违背 时 ， 您 就 得 到 一 个 提示 一 一 比如 一 个 Ant 构建 脚 
本 失败 一 一 如 清单 1 所 示 : 


清单 1. 违背 架构 导致 构建 失败 


BUILD FAILED 
build.xml:35 Test ArchitecturalRulesTest failed 


Total time: 20 seconds 


关于 本 系列 


作为 开发 人 员 ， 我 们 的 工作 就 是 为 终端 用 户 实现 过 程 自动 化 ; 然而 ， 很 多 开发 人 员 却 忽略 了 
将 自己 的 开发 过 程 自动 化 的 机 会 。 为 此 ， 我 编写 了 让 开发 自动 化 这 个 系列 的 文章 ， 专 门 探讨 
软件 开发 过 程 自动 化 的 实际 应 用 ， 并 教 您 何 时 以 及 如 何 成 功 地 应 用 自动 化 。 


本 文 所 提 及 的 技术 能 够 使 您 通过 实现 构建 自动 化 主动 分 析 软 件 架 构 。 除 此 之 外 ， 本 文 的 示例 
还 演示 了 如 何 基 于 规则 触发 构建 过 程 失败 ， 您 可 以 使 用 JDepend 的 API 和 JUnit 定义 这 些 规 
Mı] o 


当然 ， 最 重要 的 是 ， 通 过 构建 自动 化 ， 您 和 您 的 团队 能 够 在 开发 周期 的 前 期 发 现 源 代码 与 确 
定 架 构 之 间 的 偏离 。 这 就 是 我 所 说 的 掌控 架构 ! 


反应 式 地 设置 开发 阶段 


图 1 说 明了 在 构建 Web 应 用 时 一 种 常见 的 架构 模式 。 presentation 层 (代表 一 组 相关 的 
包 ) 依赖 于 controller 层 ， controller 层 依 赖 于 domain 和 business 层 ， 最 
后 ， business 层 依赖 于 data 和 domain Æ ° 


图 1. 典型 web 应 用 的 一 个 架构 分 层 图 






Presentation 
至 此 ， 一 切 都 很 好 ， 是 吗 ? 但 是 ， 我 很 确定 您 以 前 遇 到 类 似 的 情形 ， 那 些 常 见 的 最 佳 实践 规 
则 会 在 日 常 的 软件 开发 中 被 遗忘 。 事 实 上 ， 这 一 点 很 容易 (也 很 快 ) 就 会 发 生 。 


举例 而 言 ， 图 2 阅 明 了 对 该 示例 架构 的 一 个 微小 违背 ; 在 这 个 例子 里 ， data 层 至 少 调用 一 


sb z ER. 
次 business 层 : 


图 2. Data 层 正 在 调用 Business 层 的 一 个 对 象 ， 由 此 产生 了 架构 违背 
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Presentation 


架构 的 微小 变化 产生 的 意外 影响 使 代码 的 修改 变 得 更 加 困难 。 实 际 上 ， 现 在 对 一 个 代码 区 域 
的 修改 会 要 求 其 他 很 多 区 域 的 变动 。 举 例 而 言 ， 如 果 您 清除 或 改变 business 层 中 类 的 一 些 
方法 ， 则 可 能 需要 从 data 层 中 清除 某 些 引用 。 当 更 多 的 违背 发 生 时 ， 修 改 代码 就 会 更 加 困 
难 o 


若 使 用 传统 的 监控 技术 ， 比 如 查看 JDepend 或 Macker 报告 (参阅 参考 资料 ) ， 您 能 够 多 
快 地 发 现 对 期 望 设 计 的 偏离 呢 ? 如 果 您 和 我 一 样 ， 想 快速 地 生产 出 能 够 工作 的 软件 ， 那 么 越 
快 发 现 影响 交付 速度 的 问题 越 好 ， 难 道 您 不 这 么 认为 吗 ? 


使 用 简单 的 JDepend 


JDepend 是 最 方便 的 帮助 评定 架构 违背 的 工具 之 一 。 经 过 几 年 的 发 展 ， 该 开源 工具 能 够 很 好 
地 与 Ant 和 Maven 集成 ; 此 外 ， 它 对 大 量 的 Java™MAPI 提供 支持 ， 具 有 更 细 化 的 交互 性 。 
但 是 ， 如 同 我 已 经 指出 的 ， 它 生成 的 报告 本 质 上 是 被 动 的。 根据 您 实际 运行 (并 查看 ) 它们 
的 频 府 ， 和 架构 违背 可 能 直到 很 难 矫正 的 时 候 才 会 被 发 觉 。 


传 入 耦合 (Afferent coupling) 与 传 出 耦合 (Efferent 
coupling ) 


JDepend 中 ， 传 入 耦合 表示 一 些 包 的 数量 ， 这 些 包 依赖 某 个 经 过 分 析 的 包 。 比 如 说 ， 如 果 您 
正在 使 用 日 志 框架 或 一 个 象 Struts 一 样 的 Web 框架 ， 您 会 希望 这 些 包 具有 高 的 传 入 耦合 ， 
因为 整个 代码 库 的 很 多 包 都 依靠 这 些 框架 。 某 包 的 传 出 耦合 与 传 入 耦合 相反 ， 是 指 菜 个 经 过 
分 析 的 包 所 依赖 的 其 他 包 的 数量 ， 也 就 是 说 ， 它 具有 的 依赖 包 的 数量 。 


断言 架构 


要 主动 判定 架构 变动 是 否 恰当 ， 实 际 上 就 是 研究 菜 特 定 包 的 耦合 。 事 实 上 ， 通 过 对 软件 架构 
内 关键 包 的 传 入 和 传 出 耦合 进行 监控 ， 以 及 观察 预期 值 的 偏离 ， 您 能 轻松 地 发 现 错误 的 修 
改 。 


举例 而 言 ， 在 图 2 所 示 的 修改 中 ， data 层 的 新 传 出 耦合 现在 大 于 0， 因 为 该 层 目 前 要 直接 
与 business 层 通信 。 当 然 ， 这 种 耦合 是 通过 data 层 中 一 个 简单 的 import p E 
使 用 ) 而 引入 的 。 幸 运 的 是 ， rie JUnit ` JDepend 的 优秀 API 发 现 此 类 问题 ， 

有 ， 构 建 时 需要 一 些 技巧 。 


事实 证 明 ， 在 构建 (w Ant 或 Maven) 上 下 文中 ， 您 能 够 运行 使 用 JDepend API 的 JUnit 测 
试 主动 辨别 耦合 值 的 变化 ; 此 外 ， 如 果 这 些 变化 不 正确 ， 您 就 可 以 使 构建 失败 。 这 就 实现 了 
主动 性 ， 不 是 吗 ? 


第 一 步 是 创建 一 个 JUnit 测试 并 且 对 JDepend 做 相应 配置 ， 如 清单 2 所 示 : 
清单 2. 在 JUnit 中 设置 JDepend 


import junit.framework.TestCase; 
import jdepend.framework.JavaPackage; 
import jdepend.framework.JDepend; 


public class ArchitecturalRulesTest extends TestCase ( 
private static final String DIRECTORY TO ANALYZE = 
"C:/dev/project-sandbox/brewery/classes"; 
private JDepend jdepend; 
private String dataLayer - "com.beer.business.data"; 
private String businessLayer - "com.beer.business.service"; 
private Collection dataLayerViolations = new ArrayList«String»(); 


public ArchitecturalRulesTest(String name) { 
super(name); 


protected void setUp()throws IOException { 
jdepend - new JDepend(); 
jdepend.addDirectory(DIRECTORY TO ANALYZE); 
// Calling the businessLayer from the dataLayer is a violation 
dataLayerViolations.add(businessLayer); 


} 


清单 2 很 长 ， 我 们 总 结 以 下 几 个 要 点 : 


® 需要 两 个 JDepend 类 : jdepend.framework.JavaPackage 和 jdepend.framework.JDepend ° 

e 待 分 析 的 源 类 位 置 由 DIRECTORY TO ANALYZE 常量 定义 。JDepend 通过 调用 
JDepend.addDirectory 扫描 该 目录 ， 该 操作 通过 一 个 fixture 完成 (PP setup() 方法 ) » 

e 要 分 析 的 包 由 “Layer”string 定义 。 

èe dataLayerViolations Collection 添加 了 businessLayer “String (表示 一 个 包 ) 来 指明 
这 是 对 期 望 架构 的 违背 。 


按照 这 四 个 要 点 ， 我 已 经 有 效 地 设置 了 JDepend， 以 针对 特定 代码 库 发 挥 其 魔力 。 现在， 我 
要 设 定 一 些 精 确 的 逻辑 以 说 明 耦 合 值 的 变化 。 


清单 3 中 的 testpataLayer() 测试 用 例 是 架构 断言 的 核心 。 dee 是 否 存 在 对 
dataLayer 的 任何 违背 一 一 如果 isLayeringvalid() 方法 (在 下 面 的 清单 4 中 定义 ) 返回 
false ， 测 试用 例 就 被 认为 失败 ， 也 意味 着 必然 存在 一 处 架构 违背 。 


清单 3. 使 用 JDepend 测试 架构 违背 


public void testDataLayer() { 

if (!isLayeringValid(dataLayer, dataLayerViolations)) { 
fail("Dependency Constraint failed in Data Layer"); 

} 

} 


清单 3 中 测试 用 例 所 调用 的 方法 如 清单 4 所 示 : 
清单 4. 循环 查找 每 个 包 的 传 入 耦合 


isLayeringvalid() 方法 的 目的 确定 清单 2 中 DIRECTORY_TO_ANALYZE A KAMA ÉL 8 46 AG 
合 。 您 可 以 在 清单 4 底部 看 到 ， 该 方法 遵守 isEfferentsValid() 方法 ， 如 清单 5 所 示 。 


这 里 ， 如 果 isEfferentsValid() 方法 发 现 某 个 包 不 符合 指定 的 包 依赖 关系 〈 由 于 从 一 个 包 到 
另 一 个 包 的 传 出 耦合 大 于 0) ， 则 使 用 清单 2 中 的 datarayerviolations 集合 将 该 包 标 记 为 一 
个 架构 违背 。 这 将 间接 导致 testDataLayer() 测试 用 例 (如 清单 3 所 示 ) 失败 。 


清单 5. 判定 包 依 赖 关系 违背 


private boolean isLayeringValid(String layer, Collection rules) { 
boolean rulesCorrect = true; 
Collection packages = jdepend.analyze(); 
Iterator itor - packages.iterator(); 
JavaPackage jPackage - null; 
String analyzedPackageName - null; 
while (itor.hasNext()) { 
jPackage - (JavaPackage) itor.next(); 
analyzedPackageName - jPackage.getName(); 
Iterator afferentItor = jPackage.getAfferents().iterator(); 
String afferentPackageName - null; 
while (afferentItor.hasNext()) 1 
JavaPackage afferentPackage = (JavaPackage) afferentItor.next(); 
afferentPackageName = afferentPackage.getName(); 
} 
rulesCorrect = isEfferentsValid 
(layer, rules, rulesCorrect, jPackage, analyzedPackageName); 


return rulesCorrect; 


} 


正如 您 所 看 到 的 ， 清 单 2 到 5 实际 上 都 是 扫描 一 系列 包 以 确定 耦合 变化 ; 如 果 耦 合 发 生 了 变 
化 ， 失 败 条 件 被 触发 ， 因 此 JUnit 报告 测试 失败 。 要 让 我 说 的 话 ， 这 旧 是 令 人 印象 深刻 ! 


3 了 自动 运 云 行 测 iX 


一 旦 您 结合 使 用 JUnit 和 JDepend 编写 好 基于 约束 的 测试 后 ， 您 就 能 够 用 诸如 Ant 或 
Maven in 这样 的 工具 把 它 作 为 构建 过 程 的 一 部 分 运行 。 举例 而 言 ， 清 单 6 MATA Ant 运行 一 
系列 此 类 测试 。 test.dependency.dir 属性 映射 到 root/src/test/java/dependency 目录 ， 其 中 
包含 了 一 些 神奇 的 架构 验证 程序 。 


清单 6. 运行 依赖 性 约束 测试 的 Ant 脚本 


<target name="run-tests" depends="compile-tests"> 
«mkdir dir-z"$[logs.junit.dirj" /> 
«junit forkz"yes" haltonfailure-z"true"dirz"$([basedir)" printsummaryz"yes"'» 
«classpath refid-"test.class.path" /» 
«classpath refid-"project.class.path"/» 
«formatter type-z"plain" usefile-"true" /> 
«formatter typez"xml" usefile-'true" /> 
«batchtest fork-"yes" todir-"$(logs.junit.dirj"» 
«fileset dir-"$[test.dependency.dirj"» 
«patternset refid-"test.sources.pattern"/» 
«/fileset» 
«/batchtest» 
«/junit» 
</target> 


要 使 JUnit 测试 成 功 执行 ，JDepend JAR 必须 出 现在 Ant 的 类 路 径 中 。 haltonfailure 属性 
被 设 为 true， 以 便 让 构建 过 程 在 测试 失败 时 停止 。 


阅 值 驱动 的 架构 


我 已 经 指出 ， 使 用 被 动 的 方法 维持 架构 en a 了 力 ， 另外 ， 我 希望 我 已 经 使 您 相 
信 ， 开 发 过 程 中 很 容易 发 生 架构 违背 。 通 过 将 架构 测试 作为 构建 过 程 的 一 部 分 执行 ， 您 能 够 
使 这 种 检查 自动 化 并 且 能 够 重复 执行 。 图 3 显示 了 在 运行 Ant 后 显示 构建 失败 ， 这 样 不 是 很 
好 吗 ? 我 其 至 根本 不 需要 再 去 看 JDepend 报告 了 。 


图 3. 架构 违背 引起 的 构建 失败 


这 种 主动 监控 的 优势 在 于 ， 你 可 以 在 发 现 架构 分 层 问题 后 马上 解决 它 。 问 题解 决 得 越 迅速 ， 
， 您 的 团队 不 会 因此 收 到 干扰 ， 并 能 够 继续 
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工作 ， 实 现 快速 发 布 可 用 软件 的 目标 。 
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JDepend 还 有 哪些 魔力 ? 


存在 多 种 方法 通过 JDepend 添加 主动 检查 。 实 际 上 ，JDepend 建议 使 用 其 
DependencyConstraint 类 。 尽 管 使 用 DependencyConstraint 非常 简单 ， 但 我 还 是 不 选择 它 ， 
因为 它 只 具有 使 用 API 执行 架构 规则 这 么 一 种 途径 ， 而 且 不 能 可 靠 地 根据 我 的 需求 工作 。 还 


有 其 他 一 些 工具 支持 包 依赖 关系 遵从 性 ; 可 参阅 参考 资料 以 了 解 更 多 细节 。 


现在 您 能 够 用 自己 的 构建 过 程 主动 发 现 与 期 望 架构 的 设计 违背 了 。 此外， 我 已 向 您 展示 了 几 
个 可 能 的 示例 之 一 您 一 定 能 够 获得 创造 性 的 方法 并 分 析 类 似 Instability 包 这 样 的 度量 ， 
从 而 便于 判定 架构 的 整体 健壮 性 。 


我 所 介绍 的 这 个 方法 是 一 种 简单 的 方式 ， 可 以 减少 为 判定 架构 遵从 性 而 不 断 反 向 设计 代码 并 
分 析 图 表 的 需求 。 如 果 您 在 使 用 持续 集成 系统 (Continuous Integration system) ， 您 可 将 
这 些 测 试用 作 一 个 安全 网 络 ， 确 保 检查 版 本 控制 系统 的 代码 传递 这 些 架构 规则 每 当 进 行 
了 一 次 改动 时 。 如 果 您 改变 了 架构 ， 只 要 改变 您 的 JUnit 测试 规则 ， 就 可 确保 您 的 团队 遵守 
了 项 目标 准 。 这 就 是 我 所 称 的 使 用 主动 方式 断言 架构 可 靠 性 。 





让 开发 自动 化 : d 2E s 


对 代码 基 址 的 每 一 次 更 改 都 运行 自动 化 测试 


准备 好 开始 在 您 的 开发 人 员 测 试 活 动 中 大 获 全 胜 吗 ? 在 本 期 的 让 开发 自动 化 中 ， 开 发 自动 化 
专家 Paul Duvall 介绍 了 几 种 自动 化 的 开发 人 员 测 试 ， 每 一 次 改变 源 代码 都 能 够 运行 这 些 测 

iX ° Paul 提供 了 Selenium ` DbUnit 和 JUnitPerf 测试 的 例子 ， 即 ， 如 果 经 常 运行 这 些 测试 
可 以 帮助 您 尽早 发 现 应 用 程序 的 问题 。 


在 像 Eclipse 那样 的 IDE 中 或 者 比如 在 Ant 构建 脚本 中 运行 单元 测试 是 确保 应 用 程序 质量 的 
一 个 很 好 的 开始 ; 然而 ， 版 本 控制 库 (如 Subversion) 中 的 源 代码 一 改变 ， 在 单独 无 变动 的 
p o i d 周期 中 的 问题 。 而 且 ， 运 行 各 种 类 型 的 开发 人 
员 测 试 ， 如 组 件 测试 、 功 能 测试 和 性 能 测试 ， 能 够 在 开发 生命 周期 中 更 早 地 将 问题 显示 出 


关于 本 系列 


作为 开发 人 人员， 我 们 的 工作 就 是 为 终端 用 户 实现 过 程 自动 化 ; 然而 ， 很 多 开发 人 员 却 忽略 了 
将 自己 的 开发 过 程 自动 化 的 机 会 。 为 此 ， 我 编写 了 让 开发 自动 化 这 个 系列 的 文章 ， 专 门 探讨 
软件 开发 过 程 自动 化 的 实际 应 用 ， 并 教 您 何 时 以 及 如 何 成 功 地 应 用 自动 化 。 


通常 在 持续 集成 (CI) 环境 中 运行 的 开发 人 员 测 试 有 效 地 扮演 着 代码 质量 聚光灯 的 角色 。 这 
是 因为 如 果 能 有 效 地 编写 这 些 测 试 ， 则 几乎 能 够 在 问题 (如 缺陷 ) 产生 之 时 就 将 其 发 现 。 不 
经 常 运行 测试 通常 就 不 怎么 有 效 ， 因 为 从 产生 缺陷 到 发 现 该 缺陷 的 时 间 相 隔 很 长 ， 但 持续 地 
( 即 ， 每 一 次 代码 改变 时 ) 运行 测试 能 确保 快速 发 现 无 意识 的 行为 。 

本 文 涵 盖 下 列 内 容 : 

e 通过 Ant 运行 JUnit 测试 

e 使 用 JUnit 和 DbUnit 执行 更 长 时 间 的 运行 组 件 测 试 

e 使 用 JUnitPerf 确定 哪些 方法 花费 时 间 过 久 而 执 行 失败 

e 用 Selenium 运行 基于 Web 的 功能 测试 


e 用 Cobertura 访问 代码 覆盖 浴 
e 用 CruiseControl 进行 持续 测试 


我 提供 一 个 关于 不 同类 型 开发 人 员 测 试 的 概览 ， 和 一 些 可 以 添加 到 构建 过 程 并 使 用 
Continuous Integration 系统 持续 运行 的 例子 。 


按 JUnit 进行 单元 测试 


有 人 称 之 为 单元 测试 ， 有 人 称 之 为 组 件 测试 


经 常 提 到 的 单元 测试 其 实 更 像 是 一 个 组 件 级 别 的 测试 。 组 件 测试 通常 验证 不 止 一 个 类 ， 并 且 
依赖 于 一 些 东西 ， 如 数据 库 或 其 他 重量 级 系统 ， 如 文件 系统 。 但 是 更 重要 的 是 ， 在 测试 的 基 
础 上 进行 测试 ， 组 件 测试 比 单元 测试 运行 时 间 更 长 。 


有 时 ， 我 听 到 开发 人 员 将 开发 人 员 测 试 这 一 术语 与 简单 的 单元 测试 相 混淆 ; 然而 ， a 
单元 测试 这 一 术语 提 练 得 更 加 明确 很 有 帮助 。 对 我 来 说 ， 单 元 测试 是 快速 运行 的 测试 ， 
测试 没有 大 的 外 部 依赖 项 (如 数据 库 ) 的 单独 的 类 。 人 例如， 清单 1 o me ， 该 
测试 使 用 JUnit 来 验证 一 个 叫做 Beerpaostub 的 存根 数据 类 。 针 对 并 未 申 正 连接 到 数据 库 的 
接口 的 测试 技术 是 一 种 验证 业务 功能 的 方法 ， 使 用 该 方法 不 会 导致 花费 昂贵 的 设置 成 本 。 另 
外 ， 这 样 做 可 使 测试 保持 为 一 个 站 正 的 单元 测试 。 


清单 1. 一 个 简单 的 单元 测试 


public void setUp() { 
beerService - new BeerDaoStub(); 


} 


public void testUnitGetBeer() { 
Collection beers = beerService.findAll(); 


assertTrue(beers != null && beers.size() > 0); 
} 
一 旦 编写 了 一 些 单元 测试 ， 就 可 以 一 直通 过 IDE 运行 这 些 测试 ， 但 您 也 想 要 将 这 些 测试 作为 
构建 过 程 的 一 部 分 来 运行 。 确 保 该 测试 通过 构建 过 程 成 功 运行 意味 着 也 能 从 Cl 构建 的 上 下 文 


中 启动 这 些 相同 的 测试 。 


清单 2 是 一 个 Ant 脚本 片段 ， 介 绍 了 执行 一 批 单元 测试 的 junit 任务 。 这 项 任务 与 JUnit 一 
起 运作 ， 其 妙 处 在 于 : 定义 过 的 所 有 测试 现在 都 能 自动 运行 并 且 如 果 其 中 任何 一 个 测试 失 
败 ， 则 构建 也 将 失败 一 一 通过 使 用 haltonfailure 属性 实现 。 


清单 2. 在 Ant 中 运行 单元 测试 


«junit fork-z"yes" haltonfailure-"true" dir-"$(basedirj" printsummary-'yes"» 
«classpath refid-"test.class.path" /> 
«classpath refid-'"project.class.path"/» 
«formatter type-z"plain" usefile-z"true" /> 
«formatter typez"xml" usefile-'true" /> 
«batchtest forkz"yes" todir="${logs.junit.dir}"> 
«fileset dir-"$[test.unit.dirj'"» 
«patternset refid-z"test.sources.pattern"/» 
«/fileset» 
«/batchtest» 
«/junit» 


注意 * test.unit.dir 指定 测试 的 位 置 。 这 是 将 这 此 测试 (在 本 例 中 为 单元 测试 ) 和 其 他 测 
试 隔离 起 来 的 有 效 方法 。 通 过 利用 这 项 技术 ， 可 以 通过 定义 另外 的 Ant 目标 来 先 运行 较 快 的 
测试 ， 接 着 运行 较 慢 的 测试 (如 组 件 测试 、 功 能 测试 和 系统 测试 ) 。 


集合 组 件 测 试 


由 于 单元 测试 执行 得 相当 快 ， 很 容易 将 它们 作为 构建 的 一 部 分 经 常 运行 。 但 这 些 测试 并 未 达 
到 一 个 高 的 代码 覆盖 率 一 一 其 隔离 的 本 质 决定 了 它们 只 测试 一 部 分 功能 。 编 写 具有 更 多 代码 
(从 而 可 实现 更 多 功能 ) 的 测试 通常 要 以 附属 框 条 的 形式 执行 更 多 的 调查 工作 。 一 旦 开始 全 
用 这 些 帮助 框架 来 编写 测试 ， 这 些 测试 就 开始 成 为 更 高 级 别 的 测试 ， 我 把 它们 电 类 为 组 件 测 
试 。 

组 件 测试 是 基本 的 测试 ， 这 些 测试 将 验证 不 止 一 个 类 ， 且 通常 依赖 于 外 部 依赖 项 ， 如 数据 
库 。 组 件 测 试 的 编写 方式 和 单元 测试 大 体 一 致 ， 只 是 前 者 并 非 通过 模拟 或 存根 类 来 强制 隔 
离 ， 实 现 这 些 测试 可 谓 勉 为 其 难 ， 但 可 以 利用 框架 来 便利 对 外 部 依赖 项 的 使 有 用。 例如， 我 通 
常 使 用 DbUnit 框架 来 帮助 管理 数据 库 ， 以 便 组 件 测试 可 验证 依赖 数据 库 数 据 的 代码 功能 。 


用 DbUnit 控制 数据 库 状态 


DbUnit 是 一 个 框架 ， 它 使 针对 数据 库 的 测试 过 程 变 得 更 加 简单 。 它 提供 了 一 个 标准 XML 格 
式 ， 用 于 定义 一 些 测试 数据 ， 以 便 从 数据 库 中 选择 、 更 新 、 插 入 和 删除 数据 。 请 牢记 ， 
DbUnit 并 没有 替换 数据 库 ; 它 只 是 提供 了 一 种 更 加 有 效 的 机 制 来 处 理 测 试 数据 。 您 可 以 用 
DbUnit 来 编写 依赖 于 特定 数据 的 测试 ，DbUnit 保证 该 数据 位 于 底层 的 数据 库 中 。 

可 以 在 JUnit 中 可 编程 地 使 用 DbUnit， 或 者 可 以 将 它 作为 构建 过 程 的 一 部 分 使 用 。 该 框架 带 
有 一 个 Ant 任务 ， 该 任务 提供 了 一 种 使 用 XML 文件 来 操作 、 导 出 或 比较 数据 库 中 数据 的 方 
法 。 例 如 ， 清 单 3 演示 了 dbunit 任务 ， 在 本 文 的 例子 中 ， 该 任务 将 测试 数据 插入 到 目标 数 
据 库 中 ， 然 后 在 运行 完 所 有 组 件 测试 后 删除 数据 : 


清单 3. 在 Ant 中 运行 组 件 测试 


«target name="component-tests"> 
«mkdir dir-z"$[logs.junit.dirj" /> 
«taskdef name-"dbunit" 
classname-"org.dbunit.ant.DbUnitTask"/» 

«dbunit driver-z'"com.mysql.jdbc.Driver" 
url-"jdbc:mysql://localhost:3306/brewery" 
userid-"$(db.username.system)" 
classpathrefz"db.lib.path" 
passwordz"$[db.password.system)"» 
«operation type="INSERT" 

srcz"seedFile.xml"/» 

«/dbunit» 

«junit forkz"yes" haltonfailure-"false" 
failureproperty-z"tests.failed" 
haltonerror-z"true" dirz"$[basedir]" 
printsummaryz"yes"- 

«classpath refid-'"test.class.path" /> 

«classpath refid-"project.class.path"/» 

«formatter type-"plain" usefile-"true" /> 

«formatter typez"xml" usefile-'true" /> 

«batchtest forkz'"yes" todir-"$[logs.junit.dir]"'» 
«fileset dir-"$[test.component.dir)"» 

«patternset refid-'test.sources.pattern"/» 

«/fileset» 

«/batchtest» 

«/junit» 

«mkdir dirz"$í[reports.junit.dirj" /> 

«junitreport todir-"$[reports.junit.dirj"- 
«fileset dir-"$[logs.junit.dirj"» 

«include name-"TEST-*.xml" /> 
«include name-"TEST-*.txt" /> 
«/fileset» 
«report format-"frames" todir-'$í[reports.junit.dir)" /> 

«/junitreport» 

«dbunit driver-z"com.mysql.jdbc.Driver" 
url-"jdbc:mysql://localhost:3306/brewery" 
classpathrefz"db.lib.path" 
userid-"$([db.username.system]?" 
passwordz"$[db.password.system)"» 

«operation type-"DELETE" 
srcz"seedFile.xml"/» 

«/dbunit» 

</target> 


正如 清单 3 所 示 ， 现 在 组 件 测试 可 在 执行 期 间 依赖 驻 留 在 数据 库 中 的 特定 数据 。 另 外 ， 由 于 
在 所 有 测试 成 功 执行 后 删除 了 所 有 的 数据 ， 因 而 此 过 程 现在 可 重复 执行 。 


在 数据 库 中 播种 


可 以 将 dbunit 任务 的 INSERT 和 DELETE 操作 类 型 和 一 个 种 子 文件 起 使 用 ， 该 文件 包含 表 
示 数 据 库 表 和 相关 行 的 XML 元 素 。 例 如， 清单 4 是 清单 3 中 引用 的 seedFile.xml 文件 的 内 
容 。 每 个 BEER 元 素 表示 一 个 也 叫 BEER 的 数据 库 表 ， BEER 元 素 的 每 个 属性 和 其 值 都 映射 
至 相应 的 数据 库 列 名 称 和 值 。 


清单 4. DbUnit 种 子 文件 


<?xml version-'1.0' encoding-'UTF-8'?» 
«dataset» 
«BEER id-'6' 
beer name-'Guinness Extra Stout' 
brewerz'St.James Brewery' 
date received-'2007-02-01' /> 
«BEER id-'7' 
beer name-'Smuttynose Robust Porter' 
brewer-z'Smuttynose Brewery' 
date received-'2007-02-01' /> 
«BEER id-'8' 
beer name-'Wolavers pale ale' 
brewer-z'Wolaver Brewery' 
date received-'2007-02-01' /» 
«/dataset» 


您 也 许 已 经 从 清单 3 中 注意 到 ， 可 以 在 不 同 的 操作 中 重用 DbUnit 的 种 子 文件 。 在 本 文 的 例子 
中 ， 将 在 运行 组 件 测试 前 使 用 清单 4 中 的 文件 在 数据 库 中 播种 ， 然 后 使 用 相同 的 文件 指示 测 
试 完成 时 从 数据 库 中 删除 哪些 数据 。 


参与 性 能 测试 


开发 人 员 完 成 编码 后 ， 常 常 要 经 过 很 长 时 间 才 执行 性 能 测试 ， 而 事实 通常 是 可 以 在 开发 周期 
中 更 早 的 时 候 发 现 (并 且 解 决 ) 性 能 问题 。 幸 运 地 是 ， 有 一 种 方法 可 解决 此 问题 : 持续 测试 
或 更 具体 地 、 持 续 地 运行 JUnitPerf 测试 。 


对 性 能 测试 来 说 JUnitPerf 是 完美 的 


JUnitPerf 是 一 个 同 JUnit 协调 工作 的 框架 ， 该 框架 在 一 个 预定 的 时 间 限 制 内 执行 测试 用 例 : 
如 果 一 个 测试 中 的 方法 所 用 的 时 间 比 预期 的 阅 值 长 ， 则 认为 该 测试 是 失败 的 。 通 过 将 性 能 测 
试 集成 到 自动 化 构建 中 ， 您 能 有 效 地 监控 应 用 程序 的 性 能 其 至 能 在 出 现 性 能 问题 时 使 构建 失 
败 。 


但 我 倾向 于 将 JUnitPerf 用 作 一 种 发 现 早 期 性 能 问题 的 简单 方法 ， 而 不 是 将 其 作为 一 种 机 制 来 
衡量 执行 时 间 ; 像 profilers 这 样 的 工具 更 善于 提供 此 类 衡量 。 在 本 质 上 ， 可 以 认为 JUnitPerf 
是 一 个 早期 的 警告 系统 。 


在 清单 5 中 ， 我 定义 了 一 个 JUnit 测试 ， 该 测试 使 用 JUnitPef 来 验证 
BeerServicePerformanceTest 测试 类 中 的 testLongRunningMethod 测试 的 执行 时 间 。 如 果 执 行 
该 测试 方法 所 花 的 时 间 多 于 1000 毫秒 ， 则 测试 失败 。 


清单 5. 使 用 JUnitPerf 的 基于 性 能 的 测试 


package com.beer.business.service; 
import com.clarkware.junitperf.*; 
import junit.framework.Test; 


public class ExampleTimedTest { 
public static Test suite() { 
long maxElapsedTime - 1000; 
Test testCase - new BeerServicePerformanceTest("testLongRunningMethod"); 
Test timedTest - new TimedTest(testCase, maxElapsedTime); 
return timedTest; 


} 


public static void main(String[] args) { 
junit.textui.TestRunner.run(suite()); 


} 


使 用 精确 计时 作为 方法 执行 时 间 的 标准 时 要 小 心 ; 测试 的 建立 和 销毁 时 间 包 钨 在 整个 执行 时 
间 中 。 此 外 ， 在 早期 的 性 能 测试 中 ， 精 确 测定 执行 速度 在 更 大 程度 上 是 一 门 艺 术 而 不 是 科 


使 用 Selenium 进行 功能 测试 


可 随意 编写 所 有 需要 的 单元 测试 和 组 件 测试 ， 但 如 果 要 编写 一 个 提供 某 种 类 型 的 用 户 界 面 的 
应 用 程序 (例如 Web 应 用 程序 ) ， 则 需要 测试 表示 层 。 以 Web 应 用 程序 为 例 ， 需 要 验证 用 
户 场景 的 导航 ， 另 外 还 要 验证 场景 的 功能 是 正常 的 。 尽 管 如 此 ， 直 到 最 近 ， 2E 
证 明 是 一 个 负担 ， 需 要 购买 工具 来 促进 开发 周期 晚期 的 测试 。 此 外 ， 这 些 工具 几乎 不 能 
构建 过 程 ， 即 使 测试 构建 得 足够 早 也 是 如 此 。 


深入 Selenium 


但 近 几 年 来 ， 一 些 着 眼 于 功能 测试 的 开放 源码 工具 脱颖而出 ; 而 有 全， 能 轻易 地 在 开发 生命 周 
期 的 早期 使 用 这 些 工 具 。 工 具 如 Selenium 和 Watir 都 是 开放 源码 的 ; 另外 ， 它 们 构建 时 考虑 
到 了 开发 人 员 。 除 了 用 各 种 语言 (例如 Java 编程 和 Python) 编程 定义 Selenium 测试 之 外 ， 
Selenium 也 提供 了 一 种 易于 学 习 的 表格 驱动 格式 ， 此 格式 也 能 被 非 技术 类 型 使 用 。 


Selenium 框架 使 用 JavaScript 来 执行 基于 Web 的 接受 测试 ， 该 测试 打开 一 个 浏览 器 并 运行 
表格 驱动 测试 。 例 如 ， 清 单 6 展示 了 一 个 表示 简单 的 Selenium 测试 的 HTML 表 。 该 测试 的 

多 个 步骤 打开 一 个 Web 应 dap ， 然 后 dad 有 效 的 用 户 名 和 密码 执行 登录 。 测 试 结 果 生 成 到 
一 个 HTML 表 中 ， 在 Selenium 运行 完 所 有 的 测试 后 ， 能 查看 该 表 。 


清单 6. 使 用 Selenium 的 功能 测试 


«html» 

«head» 

«meta http-equiv-"Content-Type" content-"text/html; charset-UTF-8"» 

«title»MyTest«/title- 

</head> 

<body> 

<table cellpadding="1" cellspacing="1" border="1"> 

<thead> 

</thead><tbody> 

<tr> 
<td>open</td> 
<td>/beer/</td> 
<td></td> 

</tr> 

<tr> 
<td>type</td> 
<td>username</td> 
<td>admin</td> 

</tr> 

<tr> 
<td>type</td> 
<td>password</td> 
<td>password</td> 

</tr> 

<tr> 
<td>clickAndwait</td> 
«td»//input[Qvalue-'Login']«/td» 
«td»«/td» 

«/tr» 

«tr» 
«td»verifyTextPresent«/td» 
«td»Logged in as adminc/td» 
«td»«/td» 

«/tr» 

«/tbody»«/table» 

«/body» 

</html> 


使 用 清单 6 中 基于 表格 的 格式 ， 可 以 定义 多 个 接受 测试 。 也 可 以 将 测试 分 组 成 套 ， 一 次 执行 
一 整套 测试 。 


使 用 Ant 驱动 Selenium 


Selenium 的 伟大 之 处 在 于 它 是 在 考虑 了 Cl 的 基础 上 从 头 创建 的 ， 因 为 你 能 在 像 Ant 那样 的 
构建 工具 中 运行 Selenium。 此 外 ， 由 于 框架 设计 者 的 高 瞻 远 瞩 ， 如 果 任 何 Selenium 接受 测 
试 失败 ， 您 也 可 以 让 整个 构建 失败 。 例 如 ， 清 单 7 展示 了 一 个 Ant 任务 ， 该 任务 使 用 
Selenium 远程 控制 服务 器 在 一 个 Web 应 用 程序 中 执行 一 系列 表格 驱动 测试 : 


清单 7. 使 用 Ant 运行 Selenium 


<?xml versionz"1.0" encoding-"iso-8859-1"?» 
«project name-"functional-tests" default-"run-selenium-tests" basedir="."> 
«property file-"$([basedirj/selenium.properties"/» 
«import file-z"$([basedir)/common-environment.xml"/» 
«property name-"acceptance.test.lib.dir" 
value-"$[functional.test.dir)" /> 
«property name-"firefox" valuez'"*firefox" /> 
«property name-"base.url" 
value-z"http://$(web.host.name):$([web.port)" /> 
«property name-"acceptance.test.list.dir" 
value-"$[functional.test.dir)" /> 
«property name-"acceptance.test.report.dir" 
value-"$[functional.test.dir)" /> 
«target name-"run-selenium-tests"- 
«mkdir dir-"$[reports.dirj)" /> 
«java jar-"$[acceptance.test.lib.dirj/selenium-server.jar" 
forkz"true"» 
«arg line-z"-htmlSuite "$[firefoxj""/» 
«arg line-z""$[base.urlj""/» 
«arg line-z'""$[acceptance.test.list.dirj/$[test.suite]""/» 
«arg line-z""$í[reports.dirj/index.html""/-» 
«arg linez"-timeout $[timeout]"/» 
«/java» 
«/target» 
«target name="stop-server"> 
«get taskname-"selenium-shutdown" 
srcz"http://$(web.host.name): 
$(selenium.rc.port)/selenium-server/driver/?cmd-shutDown" 
dest-"result.txt" ignoreerrors-"true" /» 
«echo taskname-"selenium-shutdown" 
message-"Errors during shutdown are expected" /» 
«/target» 
«/project» 


执行 Selenium 测试 时 ， 当 框架 打开 Web 3l QN 、 闪 电 般 执行 测试 ， 然 后 关闭 该 浏览 器 并 生 
成 HTML 报告 时 ， 不 要 被 吓 到 。 这 是 一 种 在 开发 生命 周期 的 早期 更 快 更 容易 地 发 现 问 题 的 方 
法 (此 时 它们 更 易 处理 ) e 


使 用 Cobertura 4& 4 435 & is £ 


t ik | 100% 就 是 问题 所 在 


运行 像 Cobertura 或 者 Emma 这 样 的 工具 时 ， 记 住 以 下 方面 很 重要 : 在 一 个 特殊 的 方法 中 实 
现 10096 的 行 覆 盖 并 不 意味 着 该 方法 没有 缺陷 或 者 它 已 被 完全 测试 。 例 如 ， 如 果 您 编写 了 一 
个 针对 if 语句 的 测试 ， 该 测试 包含 逻辑 And ， 而 测试 针对 的 是 表达 式 的 左 侧 部 分 ， 则 像 
Cobertura 这 样 的 工具 将 报告 100% 行 尾 盖 ， 但 是 实际 上 ， 您 仅 执 行 了 该 语句 的 50% ; 因此 
仅 完成 了 50% TARZ ° 


现在 已 经 编写 了 一 些 测试 ， 如 何 确定 所 有 这 些 测 试 执行 什么 呢 ? 幸运 的 是 ， 此 问题 可 由 像 
Cobertura E ie o RR ALATRENRR AE VAR E AL 
支 复 盖 形 运行 时 所 涉及 的 代码 量 。 








in 8 展示 了 一 个 Ant 脚本 。 该 脚本 使 用 Cobertura & x —45 X T 4X8 8 3 3:89 HTML 报 
， 代 码 履 盖 率 通过 运行 一 系列 JUnit 测试 获得 : 


清单 8. 使 用 Ant 和 Cobertura 报告 代码 禾 盖 率 


«target name="instrument-classes"> 
«mkdir dir-"$[instrumented.dirj" /> 
«delete file-"cobertura.ser" /» 
«cobertura-instrument todir-"$([instrumented.dirj"» 
«ignore regex-"org.apache.log4j.*" /> 
«fileset dir-"$[classes.dirj"» 
«include name-z"**/*,class" /> 
«exclude name-z"**/*Test.class" /> 
«/fileset» 
«/cobertura-instrument» 
«/target» 


«target name-"run-instrumented-tests" depends-"instrument-classes"» 
«mkdir dir-"$[logs.junit.dirj" /> 
«junit fork-z"yes" haltonfailure-"true" dir-"$[basedirj" printsummary-"yes"» 
«sysproperty keyz"net.sourceforge.cobertura.datafile" file-'cobertura.ser" /> 
«classpath location-"$[instrumented.dir)" /> 
«classpath location-"$[classes.dir)" /> 
«classpath refid-"test.class.path" /» 
«classpath refid-"project.class.path"/» 
«formatter type-"plain" usefile-"true" /> 
«formatter type-"xml" usefile-"true" /> 
«batchtest fork-"yes" todir-"$(logs.junit.dirj"» 
«fileset dir-"$[test.component.dirj"» 
«patternset refid-"test.sources.pattern"/» 
«/fileset» 
«/batchtest» 
«/junit» 
«/target» 


cs 产生 了 一 个 如 图 1 中 所 示 的 HTML 报告 。 请 注意 行 畴 盖 和 分 支 履 盖 的 百分比 是 以 
算 的 。 可 单 击 每 一 个 包 ， 获 得 类 级 别 的 行 百 分 比 和 路 径 百分比 ， 甚 至 能 看 到 执行 的 源 代 
pd 它们 执行 的 次 数 。 


图 1. 使 用 Cobertura 和 Ant 生成 HTML 报告 
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理想 情况 下 ， 您 可 能 想 针 对 每 个 路 径 执行 一 次 测试 。 也 就 是 说 ， 如 果 整 个 代码 基 址 有 20,000 
UE RUE LAITE ^ m XX 20,000 次 测试 。 我 从 未 遇 到 过 具有 10096 的 路 径 履 盖 的 项 目 ， 不 
过 我 曾 见 过 具有 近 10096 的 行 禾 盖 的 团队 。 


已 经 介绍 了 多 种 类 型 的 测试 ， 甚 至 介绍 了 如 何 eir x Xe mix 89 E d — fg Xe 58k YA E 
常 的 间隔 执行 这 些 测 试 呢 ? 恰好 ， 这 正 是 CI1 服务 器 (如 CruiseControl) 大 显 身 手 的 地 方 ， 
接 下 来 对 它 进 行 介 绍 。 


一 旦 将 这 些 各 式 各 样 的 开发 人 员 测 试 类 型 合并 到 一 个 构建 过 程 中 时 ， 可 以 将 这 些 测试 中 的 一 
些 (或 者 全 部 ) 作为 CI 过 程 的 一 部 分 运行 。 例 如 ， 清 单 9 是 CruiseControl 的 config.xml 
文件 的 一 个 片段 ， 我 在 其 中 定义 了 一 些 东西 。 首 先 ， 我 让 CruiseControl 每 两 分 钟 监控 一 次 
Subversion 库 中 的 改变 。 如 果 发 现任 何 改变 ， 则 CruiseControl 将 启动 一 个 叫做 
build-${fproject.name}.xml 的 委托 构建 脚本 (通常 ， 此 脚本 用 Ant 编写 ) 。 该 委托 构建 脚本 
调用 项 目的 构建 脚本 ， 后 者 执行 编译 并 运行 测试 。 


我 也 定义 了 一 些 逻辑 ， 将 所 有 不 同类 型 的 测试 结果 合并 到 一 个 CruiseControl 日 志文 件 中 。 而 
且 ， 我 还 利用 CruiseControl 的 功能 将 不 同 工 具 生 成 的 报告 链接 (使 用 artifactspublisher 
标签 ) 到 Build Artifacts 链接 中 ，Build Artifacts 可 以 从 CruiseControl 的 显示 板 应 用 程序 中 获 
得 o 


清单 9. 使 用 CruiseControl 的 CI 


«modificationset quietperiod="30"> 
«svn RepositoryLocationz"http://your-domain.com/trunk/brewery" 
username-"bfranklin" 
password-"GOFlyQKite"/» 
«/modificationset» 
«schedule interval-"120"» 
«ant anthome-"apache-ant-1.6.5" buildfile-"build-$[project.namej).xml"/» 
«/schedule» 
«log dir-z"logs/$[project.namej'» 
«merge dirz'"projects/$[project.name)/ reports/unit"'/» 
«merge dir-z"projects/$[project.name)/ reports/component"/» 
«merge dir-z'"projects/$[project.name)/ reports/performance"/» 
«merge dir-z"projects/$[project.name)/ reports/functional'"/» 
«merge dir-z'"projects/$[project.name)/ reports/coverage"/» 
«/log» 
«publishers» 
«artifactspublisher 
dir-"projects/$[project.namej/ reports/" 
dest-z"projects/artifacts/$[project.name?"/» 
«/publishers» 


在 将 每 个 源 变更 应 用 到 版 本 控制 库 中 时 ， 不 必 运行 每 个 定义 的 测试 。 例 如 ， 可 以 设置 CIE 系统 
执行 构建 (通常 称 作 提交 构建 ) ， 该 构建 只 在 代码 签 入 时 运行 单元 测试 。 可 以 为 提交 构建 补 
充 一 些 更 重量 级 的 构建 ， 例 如 像 运 行 组 件 测 试 、 功 能 测试 、 性 能 测试 以 及 甚至 执行 代码 检查 
的 构建 (请 参阅 参考 资料 ) 。 这 些 构建 可 以 以 更 低 的 频率 运行 (如 一 天 一 次 ) 。 您 也 可 以 先 
择 在 提交 构建 之 后 立即 运行 这 些 测试 和 检查 。 


调用 所 有 测试 


持续 测试 包括 了 广度 和 频 度 。 通 过 授权 执行 不 同类 型 的 测试 ， 可 获得 更 大 范围 的 覆盖 和 信 
任 。 此 外 ， 通 过 持续 运行 这 些 测试 ， 几 乎 能 在 问题 产生 就 发 现 它们 。 


仅仅 进行 单元 测试 (至少 我 所 定义 的 单元 测试 ) ， 并 不 能 使 你 在 项 目 上 走 得 很 远 。 取 得 更 高 
的 代码 覆盖 率 并 且 增 加 团队 的 信心 ， 需 要 通力 合作 并 执行 自动 化 组 件 测试 、 性 能 测试 和 功能 
测试 。 此 外 ， 使 用 框架 和 像 JUnit、Selenium 以 及 Cobertura 这 样 的 工具 能 轻松 实现 构建 自 
动 化 ， 这 也 意味 着 在 CI 系统 的 帮助 下 ， 能 够 在 每 次 将 变更 提交 到 版 本 控制 库 中 时 ， 有 效 地 执 
行 测试 套件 。 这 肯定 是 一 种 万 无 一 失 的 提高 平均 成 功率 的 方法 ， 您 不 这 么 认为 吗 ? 


让 开发 自动 化 : 用 Eclipse 插件 提高 代码 质量 


在 Eclipse 中 使 用 5 个 有 用 的 插件 来 自动 化 代码 质量 分 析 


如 果 能 在 构建 代码 前 发 现代 码 中 潜在 的 问题 会 怎么 样 呢 ? 很 有 趣 的 是 ，Eclipse 插件 中 就 有 这 
样 的 工具 ， 比 如 JDepend 和 CheckStyle， 它 们 能 帮 您 在 软件 问题 暴露 前 发 现 这 些 问题 。 在 
让 开发 自动 化 的 本 期 文章 中 ， 自 动 化 专家 Paul Duvall 将 带 来 一 些 关 于 Eclipse 插件 的 例子 ， 
您 可 以 安装 、 配 置 和 使 用 这 些 静 态 分 析 插 件 ， 以 便 在 开发 生命 周期 的 早期 预防 问题 。 


关于 本 系列 


作为 一 名 开发 人 员 ， 我 们 的 工作 就 是 为 终端 用 户 将 过 程 自动 化 ; 然而 ， 我 们 当中 有 很 多 人 却 
AAA 寸 程 自动 化 的 机 会 。 为 此 ， 我 编写 了 让 开发 自动 化 这 个 系列 的 文 
， 专 门 探索 软件 开发 过 程 自动 化 的 实际 应 用 ， 并 教 您 何 时 以 及 如 何 成 功 地 应 用 自动 化 。 


开发 软件 时 ， 我 的 主要 目标 之 一 是 : 要 么 防止 将 缺陷 引入 代码 库 ， 要 么 限制 缺陷 的 生存 期 ; 
换言之 ， 要 尽早 找到 缺陷 。 很 显然 ， 越 是 了 解 如 何 编写 更 好 的 代码 以 及 如 何 有 效 测 试 软件 ， 
就 越 能 及 早 地 捕捉 到 缺陷 。 我 也 很 想 要 一 张 能 发 现 潜在 缺陷 的 安全 之 网 。 


在 本 系列 八 月 份 的 那 期 文章 中 ， 我 得 出 了 这 样 的 结论 : 将 检验 工具 集成 到 构建 过 程 (例如 ， 
使 用 Ant 或 Maven) 中 ， ws e 尽管 这 种 方法 使 一 致 性 成 为 
可 能 并 超越 了 IDE， 但 它 也 有 一 点 反作用 。 必 须 在 本 地 构建 软件 或 等 待 Continuous 
Integration 构建 的 运行 。 如 果 使 用 Eclipse 插件 ， 就 可 以 在 通过 Continuous Integration 构建 
或 集成 前 发 现 一 些 这 样 的 冲突 。 Pd Maé Miet 的 编程 方式 ， 在 这 种 方式 下 ， 人 多 
许 在 编码 过 程 中 进行 一 定 程度 的 质量 检验 这 个 更 早 了 | 





本 文 涵盖 了 我 所 认为 的 “五 大 ”代码 分 析 领 域 : 


e 编码 标准 
e 代码 重复 
e KARAZ 
° a 
e 复杂 度 监 半 


可 以 用 接 下 来 的 几 个 灵活 的 Eclipse 插件 来 揭示 这 些 分 析 领 域 : 


e CheckStyle : 用 于 编码 标准 

e PMD 的 CPD : 帮助 发 现代 码 重 复 

e Coverlipse : H ERER Žž 

e JDepend : 提供 依赖 项 分 析 

e Eclipse Metric 插件 : 有 效 地 查 出 复杂 度 


Eclipse 不 是 您 的 构建 系统 


使 用 Eclipse 插件 与 您 将 这 些 检验 工具 用 于 构建 过 程 并 不 矛盾 。 事 实 上 ， 您 想 要 确保 的 是 : 下 
列 使 用 Eclipse 播 件 的 规则 就 是 应 用 到 构建 过 程 中 的 规则 。 


安装 Eclipse 插件 


安装 Eclipse 插件 再 简单 不 过 了 ， 只 需要 几 个 步骤 。 在 开始 之 前 ， 最 好 把 该 插件 下 载 站 点 的 
URL 准备 好 。 表 1 是 本 文 用 到 的 插件 的 列表 : 


表 1. 代码 改进 插件 和 相应 的 下 载 站 点 URL 


工具 目的 Eclipse 插件 的 URL 
CheckStyle 编码 标准 分 析 http://eclipse-cs.sourceforge.net/update/ 
Coverlipse ARARA Rs E http://coverlipse.sf.net/update 
CPD 复制 /粘贴 检验 http://pmd.sourceforge.net/eclipse/ 
JDepend 包 依 赖 项 分 析 http://andrei.gmxhome.de/eclipse/ 
Metrics 复杂 度 监 控 http://metrics.sourceforge.net/update 


知道 了 这 些 有 用 插件 的 下 载 地 址 后 ， 安 装 插件 就 是 一 个 极 简单 的 过 程 。 尼 动 Eclipse， 然 后 遵 
循 下 列 步骤 : 


1. 选择 Help | Software Updates | Find and Install， 如 图 1 所 示 : 


图 1. 寻找 并 安装 Eclipse 插件 
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2. 选择 Search for new features to install 单 选 按钮 , 单 击 Next ° 
3. £4 New Remote Site， 输 入 要 安装 的 插件 名 和 URL (参见 图 2) » € OK»; A8 € 
击 Finish 来 显示 Eclipse 更 新 管理 器 。 


图 2. 配置 新 的 远程 站 点 


€- New Update Site 





Name: | PMD 








URL: | http://pmd.sourceforge.net/eclipse| 





4. 在 Eclipse 更 新 管理 器 中 ， 有 一 个 查看 插件 各 方面 特性 的 选项 。 我 通常 选择 顶级 项 ， 如 图 


3 所 示 。 选 择 您 需要 的 选项 并 单 击 Finish » Eclipse 现在 安装 该 插件 。 您 需要 重启 
Eclipse 实例 。 


图 3. 安装 Eclipse 插件 
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请 遵循 上 述 这 些 步骤 来 安装 


其 他 的 Eclipse 插件 ; 只 需 改 变 插件 名 和 相应 的 下 载 位 置 即 可 。 


用 CheckStyle 校正 标准 


代码 库 的 可 维护 性 直接 影响 着 软件 的 整个 成 本 。 另 外 ， 不 佳 的 可 维护 性 还 会 让 开发 人 员 十 分 
头痛 (进而 导致 开发 人 员 的 缺乏 ) 一 一 代码 越 容易 修改 ， 就 越 容易 添加 新 的 产品 特性 。 像 
CheckStyle 这 样 的 工具 可 以 协助 寻找 那些 可 影响 到 可 维护 性 、 与 编码 标准 相 冲 突 的 地 方 ， 比 


o 


方 说 ， 过 大 的 类 、 太 长 的 方法 和 未 使 用 的 变量 等 等 


有 关 PMD 


另 一 个 叫做 PMD 的 开源 工具 提供 的 功能 和 CheckStyle 类 似 。 我 偏爱 CheckStyle > 12 PMD 
也 有 很 多 执着 的 追随 者 ， 所 以 我 建议 您 了 解 一 下 这 个 工具 ， 毕 竞 它 也 顺 受 一 些 人 的 青睐 。 


使 用 Eclipse 的 CheckStyle 插件 的 好 处 是 能 够 在 编码 过 程 中 了 解 到 源 代码 上 下 文 的 各 种 编码 
冲突 ， 让 开发 人 员 更 可 能 在 签 入 该 代码 前 昌 正 处 理 好 这 些 冲 突 。 您 也 几乎 可 以 把 CheckStyle 
插件 视 作 一 个 连续 的 代码 复查 工具 ! 


安装 CheckStyle 插件 并 做 如 下 配置 (参见 图 4) 


1. 选择 Project， 然 后 选择 Eclipse 菜单 中 的 Properties 菜单 项 。 
2. 选择 CheckStyle active for this project 复 选 框 ， 单 击 OK。 


图 4. 在 Eclipse 中 配置 CheckStyle 插件 


€- Properties for Brewery 


Java Build Path 
+) Java Code Style 
* Java Compter 
Javadoc Location 
Project References CR configuration that checks the sun coding conventions. 


Exclude from checking... 
all flle types except: java, properties 


C files from non source directories 
C files in sync with the CVS reposkory 





Eclipse 重新 构建 工作 空间 ， 并 在 Eclipse 控制 台中 列 示 已 发 现 的 编码 冲突 ， 如 图 5 所 示 : 


图 5. Eclipse 中 CheckStyle 的 代码 冲突 列表 
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long maxElapsedTime - [fH 


Test testCase = new DeerServicePerformanceTest(TEST PERFORMANCE GET BE —— 
Test tiíimedTest = new TimedTest[restCase, maxElapsedTime): 


return timedTest; 
, 


public static void main|String(] args) 《 
junit.textui.TestRunnet.rzun(surite(]): 
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使 用 CheckStyle 插件 在 Eclipse 内 诅 入 编码 标准 检验 是 一 种 很 棒 的 方法 ， 用 这 种 方法 可 以 在 
编码 时 积极 地 改进 代码 ， 从 而 在 开发 周期 的 早期 发 现 源 代码 中 潜在 的 缺陷 。 这 么 做 还 有 更 多 
的 好 处 ， 如 节省 时 间 、 减 少 失 败 ， 也 因此 会 减少 项 目的 成 本 。 没 错 ， 这 就 是 一 种 积极 主动 的 
方式 ! 


用 Coverlipse UA 3 A 


Coverlipse 是 一 个 用 于 Cobertura 的 Eclipse 4&4} > Cobertura -ARER s 3E LR. » TA 
用 liti 测试 的 源 代码 的 比率 。Cobertura e Ant 任务 和 Maven 插件 ， 
但 用 Cobertura， 您 可 以 在 编写 代码 时 评估 代码 履 盖 率 。 您 见 过 这 样 的 模式 吗 ? 


通过 选择 E 菜单 项 Run 安装 Coverlipse 插件 并 将 其 和 JUnit 关联 起 来 ， 该 操作 会 显 
一 系列 运行 配置 选项 ， 例 如 JUnit、SWT 应 Mud Java™ 应 用 程序 。 右 键 单 击 s f 
JUnit DANSE 点 中 的 New。 在 这 里 ， 需 要 确定 JUnit 测试 的 位 置 ， 如 图 6 所 示 : 


图 6. 配置 Coverlipse 以 获取 代码 覆盖 率 


让 开发 自动 化 系列 专栏 


Create, manage, and run configurations 
Run JUnit with Coverlpse 
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[7] Keep JUnit w/Coverlipse running after a test run when debugging 





一 旦 单 击 了 Run’ Eclipse 会 运行 Coverlipse 并 在 源 代码 (如 图 7 所 示 ) P dk die o ARS 
记 显示 了 具有 相关 JUnit 测试 的 代码 部 分 : 


图 7. Coverlipse 生成 的 具有 误 入 类 标记 的 报告 
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Rue: W tror: 10Fehres v Connection getConnection|String driver, String url, String username, B getConnectio 
e 3 
EE - TEER m t QuConnecto 
ei Connection conn * mull; a t$ dione 
* B con.beerbusness.sere.Bee 74 bx 
' try ( 
Class.forName(driver]; 
conn = DriverManager.getConmection(url, username, password); 
conn.setAutoConmit (false) ; 
) catch [SQLException se) í - 
) throw new Runtimelxception(se); 
ü 1 ) catch [ClassNotFoundExceprtiom ce) i v 
< » 
Problems Javadoc Dedaration. Console. Coweripse Class View Ia 
onkent Description of CoveragelMariker View 
< » Message 


S Pale Trece z This ine was hy covered 
This ine was fuy covered 
This ine was hly covered 
This ine was not covered 
This line was not covered 

ii This ine wars Ndy covered 


gd This ine was fully covered 
Ba This line was l'ully covered 





Evaluating rens: (76%) GC Ee 
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正如 您 所 见 ， 使 用 Coverlipse Eclipse 插件 可 以 更 快 地 确定 代码 覆盖 举 。 例 如 ， 这 种 实时 数据 
功能 有 助 于 在 将 代码 签 入 CM 系统 前 更 好 地 进行 测试 。 这 对 渐进 编程 来 说 意味 着 什么 呢 ? 


用 CPD 捕捉 代码 重复 


Eclipse 的 PMD 插件 提供 了 一 项 叫做 CPD (或 复制 粘贴 探测 器 ) 的 功能 ， 用 于 寻找 重复 的 代 
码 。 为 在 Eclipse 中 使 用 这 项 便利 的 工具 ， 需 要 安装 具有 PMD 的 Eclipse 插件 ， 该 插件 具有 
CPD 功能 。 


为 寻找 重复 的 代码 ， 请 用 右键 单 击 一 个 Eclipse 项 目 并 选择 PMD | Find Suspect Cut and 
Paste， 如 图 8 所 示 : 


图 8. 使 用 CPD 插件 运行 复制 粘贴 检验 




















Mew > 
B i Brewery Go Into 
[42]... C3 
x = t Open in New Window 
由 ests 
E Open Type Hierarch F4 
由 tests HOUR T 
H- tests [iz [B Copy Ctrl+C 
H-A JRE $ E3 
H- confi] aa 
H Paste Ctrl 十 
由 -E> datal Wa Pa 
a- lib 3€ Delete Delete 
由 ym tests ^ Build Path g 
ri ER Source Alt+Shift+5 » 
m Refactor Alt+Shift+T » 
iX] carg 
(X) checl gs Import... 
checl 14 Export... 
X] cobe 
cobe| «® Refresh FS 
X| comn Close Project 
DÒ) comn z 
X) comp Run ås 
R) cpd-t Debug ås > 
cpd.r Profile As 上 


X) dbun Validate 

dbun Analysis » 
defai Fix Copyrights... 

IX] javar & Force File Synchronization 

javar Team » 
X] jdepe Compare With 

jdept Restore from Local History... 








P Generate reports 











IX] junit] Eind Bugs » P Clear violations reviews 
junit, Review »| J Find Suspect Cut And Paste 
local, 


E PDE Tools » P Clear PMD violations 
T RE eeni 
T^ RS B 


Sirnism 


一 旦 运行 了 CPD， 您 的 Eclipse 根 目录 下 就 会 创建 出 一 个 report. 文件 夹 ， 其 中 包含 一 个 叫 
做 cpd.txt 的 文件 ， 文 件 中 列 示 了 所 有 重复 的 代码 。 图 9 中 是 一 个 cpd.txt 文件 的 例子 : 


图 9. Eclipse 插件 生成 的 CPD 文本 文件 


4) Be Edt yew Search Qocument Projet Jools window teip 
Gita xev &&X|oc/wiuycAlwisu5muve 
ound a 19 line (97 tokens] duplication in the following files: 


Starting at line 19 of C:idev|ibrewery^testsiunit|com|beer|business|serviceNMBeerServiceUnitTest.java 
Starring at line 19 of C:idevibrewery^cesctasipertorsanceNcomVbeerbusinessVserviceiBeerSetvicePerformanceTest, Java 





public void testPerformanceGetBeer() { 
Collection beers = beerService.findA11():; 
java.util.Iterator itor = beers.iterator():; 
String name = null; 
Beer beer = null; 
while (itor.hasNext(]) ( 
beet = (Beer) itor.nexc(): 
nane = beer,getNane(): 
S$ystem.out.printlin("namxels" + name); 
) 


if (beers '» null 66 beers.siíze() > 0) ( 
assertTrue([true); 

) else | 
assercTrue (false): 


HEMEUEFEEEESEERESESEESSEEEEHTEENSEEENSEEENMEENSEEEEEEEFESSTEENEM"ESSUE"UTTT 
Found àa 17 line (96 tokens] duplication in the following files: 

Starting at line 19 of C: Xdev|breweryAtestsiunit|com|ibeer|business|serviceVBeerServiceUnitTest.java 

Starting at line 20 of C:idevibrewery^tests|icomponent|com|beer|business|servicelBeerServiceComponentTe3t, java 


public void testComponentGetBeer() ( 
Collection beers = beerService.findAll():; 
java.util.Iterator itor = beers.iterator(]; 
String name = null; 
Beer beer = null; 
while (itor.hasNext()) ( 
beer = (Beer) itor.next():; 
nage = beer, getName (); 
Systen.out.println("namels" + name); 
} 
if (beers != null éé beers.size() > 0) ( 
回 9qgdrepetot 
For Help, press F1 hi coli 96 


靠 人 工 来 寻找 重复 的 代码 是 一 项 挑战 ， 但 使 用 像 CPD 这 样 的 插件 却 能 在 编码 时 轻松 地 发 现 重 
复 的 代码 。 


使 用 JDepend 进行 依赖 项 检查 


JDepend 是 个 可 免费 获取 的 开源 工具 ， 它 为 包 依 赖 项 提供 面向 对 象 的 度量 值 ， 以 此 指明 代码 
库 的 弹性 。 换 名 话说 ，JDepend 可 有 效 测量 一 个 架构 的 健壮 性 (反之 ， 脆 弱 性 ) o 


除了 Eclipse 插件 ，JDepend 还 提供 一 个 Ant 任务 、Maven 插件 和 一 个 Java 应 用 程序 ， 用 
以 获取 这 些 度量 值 。 对 于 相同 的 信息 ， 它 们 有 着 不 同 的 传递 机 制 ; 但 Eclipse 插件 的 特别 之 处 
和 相应 优点 是 : 它 能 以 更 接近 源 代码 ( 即 ， 编 码 时 ) 的 方式 传递 这 条 信息 。 


图 10 演示 了 使 用 Eclipse JDepend 插件 的 方法 : 通过 右键 单 击 源 文件 夹 并 选择 Run 
JDepend Analysis。 一 定 要 选择 一 个 含 源 代码 ede 否则 看 不 到 此 菜单 项 。 


1 ? 只 


Zo 
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图 10. 使 用 JDepend Analysis 分 析 代 码 








































gl Beer 
eise 
ES Brewery ^ 19 
HgS 20 
由 New » 
Gf ^^ GoInto 
由 
| 由 n Open in New Window 
: og e Open Type Hierarchy F4 
n jal Copy Ctrl+C 
自 e EN Copy Qualified Mame 
E-e (E) Paste Ctrlev 
Eg 3€ Delete Delete 
Build Path LÀ 
Source Alt+Shift+5 P 
Refactor Alt+Shift+T P 
È Import... 
Lå Export... 
p=.. | Refresh F5 
ZI Violatioi ® iain 
, Error Run As » 
pK Avoid Debug ås d 
» Avoid Profile As d 
» Avoid Validate 
由 Syster Analysis » 
pK Syster Run JDepend analysis 





图 11. Eclipse 项 目 中 的 包 依 赖 项 
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E Depend - BeerDaolmpl. java - Eclipse SOK 
Ge 内 Sauce Relator Maveste Seych Bowct Deidíssst Bn window bp 
#- 0- a- OB 7.9929 ' £3 by Depend ~ 


&7 ] | y Dependencies 
Selected obyect(s) 





Package CQc.. Aca. CM». Ce. A I D Cydel 
E cons beer business sorvico $ i 1 L] 0.14 0.06 0.03 


Packages wth cyde 
Package Coie.. AC. Cala. Cole.. A I b Cyde! 


Depends upon - efferenkt dependencies 





Package COc. AX. Ca. Cele,,, A 1 [] Cyder 
出 com beer business Sata 1 t 6 0.50 0.25 0.35 
E con. beer business. doman 2 o 3 1 0.00 025 0.75 
4B cons. darosare jurdperf 0 o t 0 0.00 0.00 1.00 
B jun frames 0 o 1 0 0.00 0.00 1.00 
IB rrt tertu 0 © t 0 0.00 0.00 1.00 
Used by - alferent dependencies 
Package CQc. Aca. Ca. Cole. A 1 5 Cyde! 
Ë con beer. web 1 o 0 ?7 0.00 1.00 0.00 
irit abd 
B 
Abs 


正如 您 所 见 ，JDepend 插件 提供 了 有 助 于 不 断 观 察 架构 可 维护 性 变化 的 大 量 信 息 一 一 这 其 中 
最 大 的 好 处 是 您 可 以 在 编码 时 看 到 这 些 数据 。 


用 Metrics 测量 复杂 度 


“五 大 ”代码 分 析 最 后 的 一 项 是 测量 复杂 度 提供 一 种 叫做 Metrics 的 插件 ， 使 用 该 插 
件 可 以 进行 许多 有 用 的 代码 度量 ， 包 括 圈 复 杂 度 度量 ， 它 用 于 测量 方法 中 惟一 路 径 的 数目 。 
安装 Metrics 插件 并 重启 Eclipse : 然后 遵循 下 列 步 骤 : 


1. 右键 单 击 您 的 项 目 并 选择 Properties 菜单 。 在 结果 窗口 中 ， 选 择 Enable Metrics 
plugin 复 选 框 并 单 击 OK， 如 图 12 所 示 : 


图 12. 为 项 目 配置 Metrics 


站 开 必 自动 化 . 用 Fanlinen 持 件 担 言 人 三 后 号 440 
-H A BE 2916: ^] Eclipse 4& F4 rm 1X5 Iv xe | 20 
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€ Properties for Brewery 


-Refactoring History 


mr —— 





2. 从 Eclipse 中 选择 Window 菜单 打开 Metrics 视图 ， 然 后 选择 Show View | Other... 。 
3. 选择 Metrics | Metrics View 打开 如 图 13 中 显示 的 窗口 。 您 需要 使 用 Java 透视 图 并 重 
新 构建 项 目 ， 从 而 显示 这 些 度量 值 。 


图 13. 打开 Eclipse 中 的 Metrics View 


让 开发 自动 化 : 用 Eclipse 插件 提高 代码 质量 131 


让 开发 自动 化 系列 专栏 


£— Show View 


type filter text 


E-E General 
H-S Ant 
H-E Cheat Sheets 
H-E CY5 
H-E Debug 
H-E Help 
由 -外 Java 
H-E Java Browsing 
B-E Metrics 
| II Dependency Graph view 
i H Layered Package Graph view 
: B Layered Package Table View 
i B Metrics View 
H- PDE 
H-E PDE Runtime 
H-E Team 











4. 单 击 OK 来 显示 如 图 14 中 的 窗口 。 





在 此 例 中 ， 我 正在 查看 一 个 单独 方法 的 圈 复 杂 度 。 申 正 妙 的 是 您 可 以 双击 Metrics 列表 中 
的 方法 ， 该 插件 会 在 Eclipse 编辑 器 中 为 此 方法 打开 源 代码 。 这 就 让 修正 变 得 超级 简单 


(如 果 需 要 的 话 ) | 


图 14. 查看 方法 的 圈 复 杂 度 


D eeerpoompljave SE 

stmt = conn.prepareStatement (sq1); 

rs = stmt.executeQuery(): 

while (rs.next()) ( 
State state = new State(): 
state.setState(rs.getString("state")):; 
state.setDescription(rs.getString("description")]:; 
srates,.add(state) ; 














Metric 2 L Total — Mean Std. D... Maximum Resource causing Maximum 了 
& Number of Static Attributes (avgjmax per type) 10 083 1.462 4 [Erewery/srcicomibeer commoni Constants. java 
i$ Nested Block Depth (avg/max per method) 1.429 0.695 3 JBreweryjsrcicomibeer /business/data/BeerDao[mpl. java 
i$ Number of Methods (avglmax per type) 38 3.1167 2.115 8 jBrewery/srcicom/beer /busness/domsin/Beer java 
8 Lack of Cohesion of Methods (avgjmax per type) 0.127 0.287 0.857 /Erewery/src/com/beer business domain/Beer java 
& McCabe Cyclomatic Complexity (avglmax per math 1.81 1.384 6 [Erewery/src/comibeer web/ServletController java 
m suc 1.608 1.442 6 [Brewery[src/comjbeer /web]ServietController java 
国 com,beer web 4 2.16 6 [Breweryjsrcicomibeer/web]Servlet Controller java 
B com,beer.common 2.5 1.658 5 [Brewery[ercjcomjbeer/common]BaseDao. java 
& com. beer business data 2.25 0.829 3 [Brewery]srcicomjbeer /businessidat a/BeerDaoImol.java 
S BeerDaolmpl.java 225 0,829 3 [Brewerylsrcicomibeer/business/data/BeerDao mol, java 
BeerDaolmol t 829 ) | JBreweryisrcicomibeer /business/data/BeerDaolmopl.java 
findAl 3 
find States 3 
create 2 
BeerDaolmpl 1 
BeerDao.java 0 0 
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正如 我 之 前 提 到 过 的 ，Eclipse Metrics 插件 还 提供 了 许多 功能 强大 的 度量 值 ， 有 助 于 您 在 开 
发 软件 的 过 程 中 改进 代码 一 一 可见 ， 它 是 一 个 渐进 编程 意义 上 的 插件 ! 


合适 的 才 是 最 好 的 


D Td ARI o KERK M EYA” FRAGE (XU RARA ORG 
项 分 析 和 复杂 度 监控 ， 用 于 改进 代码 质量 十 分 重要 。 但 适合 您 的 才 是 好 的 。 请 记 住 还 有 其 他 

许多 可 用 的 Eclipse m (比如 PMD 和 FindBugs) 能 够 帮助 您 在 开发 周期 的 早期 改进 代码 

质量 。 不 管 您 想 要 的 工具 或 偏爱 的 方法 是 什么 ， 重 要 的 是 : 行动 起 来 去 积极 改进 代码 质量 并 

让 手工 代码 检验 的 过 程 变 得 更 加 有 效 。 我 估计 您 使 用 这 些 插件 一 段 时 间 后 ， 就 再 也 离 不 开 它 

们 了 。 


让 开发 自动 化 : 除 看 构建 脚本 中 的 气味 


创建 一 致 、 可 重复 、 可 维护 的 构建 


您 把 多 少时 间 花 在 维护 项 目 构建 脚本 上 ?也 许 远 远 超出 您 预期 的 或 者 可 以 忍受 的 时 间 。 其 实 
Ap Tai yen 的 经 历 。 在 这 一 期 的 让 开发 自动 化 中 ， 开 发 自动 化 专家 Paul Duvall 将 
演示 如 何 改 进 见 的 妨碍 团队 创建 一 致 的 、 可 重复 的 、 可 维护 的 构建 的 实践 。 


当 描 述 代码 之 类 的 东西 时 ， 我 不 喜欢 “气味 (smell) "这 个 词 。 因 为 用 拟人 的 手法 来 谈论 比特 
和 字 节 往往 令 人 觉得 很 怪异 。 并 不 是 说 “气味 "这 个 词 不 能 准确 地 反映 出 茶 种 表明 代码 可 能 有 错 
误 的 症状 ， 只 是 我 觉得 这 样 听 起 来 很 滑稽。 然而 ， 我 依然 选择 再 次 用 这 种 令 人 厌烦 的 方式 来 
描述 软件 构建 ， 坦 白 说 ， 这 是 因为 这 些 年 我 见 过 的 很 多 构建 脚本 都 散发 着 难 闻 的 气味 。 


创建 构建 脚本 时 ， 即 使 是 伟大 的 程序 员 也 常常 会 遇 到 困难 。 就 好 像 最 近 才 学 会 如 何 编 写 程 
^ 性 代码 似 的 一 一 他 们 还 会 编 RP ELEM 通过 复制 -粘贴 编写 代码 、 对 属性 进 
行 硬 编码 等 等 。 我 总 是 很 想 知 道 为 什么 会 这 样 。 也 许 是 因为 构建 脚本 没有 被 编译 成 客户 最 终 
Que ATA Pütc E RICE USC 构建 脚本 是 中 心 ， 如 果 那 些 
脚本 败 妹 其 中 ， 那 么 要 想 有 效 地 创建 软件 ， 就 需要 克服 重重 挑战 。 


幸运 的 是 ， 您 可 以 轻松 地 在 构建 (不 管 是 Ant^ Maven 还 是 定制 的 ) 之 上 部 署 一 些 实践 ， 

们 虽然 可 以 帮助 您 创建 一 致 的 、 可 重复 的 、 可 维护 的 构建 ， 但 其 过 程 会 很 长 。 Rouen 
更 好 的 构建 脚本 的 一 种 有 效 的 方法 是 搞 清楚 哪些 事情 不 要 去 做 ， 理 解 其 中 的 道理 ， 然 后 看 看 
做 事 的 正确 方法 。 在 本 文中 ， 我 将 详细 论述 您 应 该 避免 的 9 种 最 常见 的 构建 中 的 气味 ， 为 什 
么 应 该 避免 它们 ， 以 及 如 何 修复 它们 : 


e。 惟 IDE 的 构建 

e 复制 -粘贴 式 的 编写 脚本 方法 
e 宛 长 的 目标 

e 庞大 的 构建 文件 

e 没有 清理 干净 

o 硬 编码 的 值 

e. 测试 失败 还 能 构建 成 功 

e 魔力 机 

e 格式 的 缺失 


关于 本 系列 


作为 一 名 开发 人 员 ， 我 们 的 工作 就 是 为 用 户 将 过 程 自动 化 。 然 而 ， 我 们 当中 有 很 多 人 却 忽 视 
了 将 我 们 自己 的 开发 过 程 自动 化 的 机 会 。 为 此 ， 我 编写 了 让 开发 自动 化 这 个 系列 的 文章 ， 专 
门 探索 软件 开发 过 程 自动 化 的 实际 应 用 ， 并 教 您 何 时 以 及 如 何 成 功 地 应 用 自动 化 。 


这 里 无 意 给 出 完整 的 列表 ， 不 过 这 份 列表 的 确 代表 了 近年 来 我 读 过 的 和 写 过 的 构建 脚本 中 ， 
我 遇 到 的 较为 常见 的 一 些 气味 。 有 些 工具 ， 例 如 Maven， 是 为 处 理 与 构建 有 关 的 很 多 管道 而 
设计 的 ， 它 们 可 以 帮助 减轻 部 分 气味 。 但 是 无 论 使 用 什么 工具 ， 还 是 有 很 多 问题 会 发 生 。 


避免 惟 IDE 的 构建 


W IDE (IDE-only) 的 构建 是 指 只 能 通过 开发 人 员 的 IDE 执行 的 构建 ， 不 幸 的 是 ， 这 似乎 在 
构建 中 很 常见 。 惟 IDE 的 构建 的 问题 是 ， 它 助长 了 “在 我 的 计算 机 上 能 运行 "问题 ， 即 软件 在 
开发 人 员 的 环境 中 可 以 运行 ， 但 是 在 任何 其 他 人 的 环境 中 就 不 能 运行 。 而 且 ， 由 于 惟 IDE 构 
建 自动 化 程度 不 是 很 高 ， 因 而 为 集成 到 持续 集成 (Continuous Integration) 环境 带 来 极 大 的 
挑战 。 实 际 上 ， 没 有 人 为 的 干预 ， 惟 IDE 常常 无 法 自动 化 。 


我 们 要 清楚 : 使 用 IDE 来 执行 构建 并 没有 错 ， 但 是 IDE 不 应 该 成 为 能 构建 软件 的 惟一 环境 。 
特别 是 ， 一 个 完全 用 脚本 编写 的 构建 ， 可 以 使 开发 团队 能 够 使 用 多 种 IDE， 因 为 只 存在 从 IDE 
到 构建 的 依赖 性 ， 而 不 存在 相反 方向 的 依赖 性 ， 如 图 1 所 示 : 


图 1. 1DE 与 构建 的 依赖 关系 


mnm 
Eclipse IDE 1. 
“Sa 
Build script 
O] 


L2 


Oo | 

[D | 
4E IDE 的 构建 有 碍 自动 化 ， 清 除 的 惟一 方法 就 是 创建 可 编写 脚本 的 构建 。 有 足够 的 文档 和 太 
多 的 书籍 可 以 为 您 提供 指导 ( 见 参考 资料 ) ， 而 像 Maven 之 类 的 项 目 也 为 从 头 开 始 定 义 构 建 


提供 了 极 大 的 方便 。 不 管 采用 何 种 方法 ， 都 是 选择 一 种 构建 平台 ， 然 后 尽快 地 让 项 目 成 为 可 
编写 脚本 的 。 


复制 -粘贴 就 像 廉价 的 香水 


复制 代码 是 软件 项 目 当 中 一 个 常见 的 问题 。 实 际 上 ， 甚 至 很 多 流行 的 开放 源码 项 目 都 存在 
2096 到 3096 的 复制 代码 。 代 码 复制 令 软 件 程序 更 难于 维护 ， 同 理 ， 构 建 脚本 中 的 复制 代码 
也 存在 这 样 的 问题 。 例 如 ， 想 象 一 下 ， 假 设 您 需要 通过 Ant 的 fileset 类 型 引用 特定 的 文 
件 ， 如 清单 1 所 示 : 


清单 1. 复制 -粘贴 Ant 脚本 


«fileset dirz"./brewery/src" > 
«include namez"**/*,java"/» 
«exclude namez"**/*,.groovy"/» 

«/fileset» 


如 果 需 要 在 其 他 地 方 引用 这 组 文件 ， 例 如 为 了 编译 、 检 查 或 生成 文档 ， 那 么 最 终 您 可 能 会 在 
多 个 地 方 使 用 相同 的 fileset 。 如 果 在 将 来 某 个 时 候 ， 您 需要 对 那个 fileset 做 出 修改 〈 比 
如 说 排除 groovy 文件 ) ， 那么 最 终 可 能 需要 在 多 个 地 方 做 更 改 。 显 然 ， 这 不 是 可 维护 的 解 
决 方案 。 然 而 ， 要 除 掉 这 股 气味 其 实 很 简单 。 


如 清单 2 所 示 ， 通 过 Ant 的 patternset 类 型 可 以 引用 一 个 逻辑 名 称 ， 以 表示 所 需要 的 文 
件 。 那 么 ， 当 需要 向 fileset 添加 (或 排除 ) 文件 时 ， 只 需 更 改 一 次 。 


清单 2. 复制 -粘贴 Ant 脚本 


<patternset id="sources.pattern"> 
«include namez"**/*,java"/» 
«exclude namez"**/*,.groovy"/» 
«/patternset» 


«fileset dirz"./brewery/src"» 
«patternset refid-z'"sources.pattern"/» 
«/fileset» 


对 于 精通 面向 对 象 编程 的 人 来 说 ， 这 种 修复 方法 看 上 去 很 熟悉 : 既定 的 惯例 不 是 在 不 同 的 类 
中 一 次 又 一 次 地 定义 相同 的 逻辑 ， 而 是 将 那个 逻辑 放 在 一 个 方法 中 ， 在 不 同 地 方 都 可 以 调用 
这 个 方法 。 于 是 ， 这 个 方法 成 为 惟一 的 维护 点 ， 从 而 可 以 限制 错误 级 联 并 可 以 鼓励 重用 。 


不 要 掺 入 宛 长 目标 的 气味 


Martin Fowler 在 他 撰写 的 Refactoring 这 本 书 中 ， 对 代码 中 存在 兄长 方法 的 气味 这 个 问题 做 
了 精妙 的 描述 过 程 越 长 ， 越 难 理解 。 实 际 上 ， 宛 长 方法 最 终 会 担负 太 多 的 责任 。 当 谈 到 
构建 时 ， 宛 长 目标 这 种 构建 气味 是 指 更 难于 理解 和 维护 的 脚本 。 清 单 3 就 展示 了 一 个 相当 元 
长 的 目标 : 





清单 3. TKR i 


«target name="run-tests"> 
«mkdir dir-"$[classes.dirj"/» 
«javac destdir-"$[classes.dirj" debug="true"> 
«src pathz"$[src.dirj" /> 
«classpath refid-"project.class.path"/» 
«/javac» 
«javac destdir-"$[classes.dirj" debug="true"> 
«src pathz"$[test.unit.dirj"/» 
«classpath refid-'"test.class.path"/» 
«/javac» 
«mkdir dir-"$[logs.junit.dirj" /> 
«junit fork-"yes" haltonfailure-"true" dir="${basedir}" printsummary-"yes"» 
«classpath refid-'test.class.path" /> 
«classpath refid-'"project.class.path'"/» 
«formatter type-z"plain" usefile-"true" /> 
«formatter typez"xml" usefile-'true" /> 
«batchtest forkz'"yes" todir-"$[logs.junit.dir]'» 
«fileset dir-"$[test.unit.dirj"» 
«patternset refid-'test.sources.pattern"/» 
«/fileset» 
«/batchtest» 
«/junit» 
«mkdir dir-"$[reports.junit.dirj" /> 
«junitreport todir-"$[reports.junit.dirj"-» 
«fileset dir-"$[logs.junit.dirj"» 
«include name-"TEST-*.xml" /> 
«include name-"TEST-*.txt" /> 
«/fileset» 
«report format-"frames" todir-'$í[reports.junit.dirj)" /> 
«/junitreport» 
</target> 


这 个 见长 的 目标 (相信 我 ， 我 还 见 过 兄长 得 多 的 目标 ) 要 执行 四 个 不 同 的 过 程 : 编译 源 代 

码 、 编 译 测试 、 运 行 JUnit 测试 和 创建 一 个 JUnitReport。 要 担负 的 责任 已 经 够 多 了 ， 更 不 用 
说 将 所 有 XML 放 在 一 个 地 方 所 增加 的 相关 的 复杂 性 。 实 际 上 ， 这 个 目标 可 以 拆 分 成 四 个 不 同 
的 、 逻 辑 上 的 目标 ， 如 清单 4 所 示 : 


清单 4. 提取 目标 


«target name-"compile-src'» 
«mkdir dir-"$[classes.dir)"/» 
«javac destdir-"$[classes.dirj" debug="true"> 
«src pathz"$[src.dirj" /> 
«classpath refid-'"project.class.path'"/» 
«/javac» 
«/target» 


«target name-z"compile-tests"- 
«mkdir dir-"$[classes.dirj"/» 
«javac destdir-"$[classes.dirj" debug="true"> 
«src pathz"$[test.unit.dirj"/» 
«classpath refid-'"test.class.path"/» 
«/javac» 
</target> 


<target name="run-tests" depends="compile-src,compile-tests"> 
«mkdir dir="${logs.junit.dir}" /> 
<junit fork="yes" haltonfailure="true" dir="${basedir}" printsummary="yes"> 
<classpath refid="test.class.path" /> 
<classpath refid="project.class.path"/> 
<formatter type="plain" usefile="true" /> 
«formatter typez"xml" usefile="true" /> 
«batchtest forkz'"yes" todir-"$[logs.junit.dir]"'» 
«fileset dir-"$[test.unit.dirj"» 
«patternset refid-'test.sources.pattern"/» 
«/fileset» 
«/batchtest» 
«/junit» 
</target> 


<target name="run-test-report" depends="compile-src,compile-tests,run-tests"> 
<mkdir dir="${reports.junit.dir}" /> 
<junitreport todir="${reports.junit.dir}"> 
<fileset dir="${logs.junit.dir}"> 
«include name-"TEST-*.xml" /> 
«include name-"TEST-*.txt" /> 
«/fileset» 
«report format-"frames" todir-'$í[reports.junit.dir)" /> 
«/junitreport» 
«/target» 


可 以 看 到 ， 由 于 每 个 目标 只 担负 一 种 责任 ， 清 单 4 中 的 代码 理解 起 来 要 容易 得 多 。 根 据 用 途 
分 离 目标 ， 不 但 可 以 减少 复杂 性 ， 还 为 在 不 同上 下 文中 使 用 目标 创造 了 条 件 ， 必 要 时 还 可 以 
重用 。 


庞大 的 构建 文件 也 有 一 种 很 重 的 气味 


Fowler 还 将 庞大 的 类 也 看 作 一 种 代码 气味 。 就 构建 脚本 而 言 ， 有 这 种 类 似 气味 的 就 是 庞大 的 
构建 文件 ， 它 相当 难以 读 懂 。 很 难 知道 哪个 目标 是 做 什么 的 ， 目 标的 依赖 关系 是 什么 。 这 同 
样 会 给 维护 带 来 问题 。 而 有 全 ， 庞 大 的 构建 文件 通常 有 相当 多 的 剪 切 -粘贴 的 痕迹 。 


为 了 缩小 构建 文件 ， 可 以 从 脚本 中 找 出 逻辑 上 相关 的 部 分 ， 将 它们 提取 到 更 小 的 构建 文件 
中 ， 由 主 构建 文件 来 执行 这 些 较 小 的 构建 文件 (例如 ， 在 Ant 中 ， 可 以 使 用 at 任务 调用 其 
他 构建 文件 ) 。 


通常 ， 我 喜欢 根据 核心 功能 拆 分 构建 脚本 ， 确 保 它们 可 以 作为 独立 脚本 来 执行 ( 想 想 构建 组 
件 化 ) 。 例 如 ， 在 我 的 Ant 构建 中 ， 我 喜欢 定义 四 种 类 型 的 开发 者 测试 : 单元 、 组 件 、 系 统 
和 功能 。 而 有 全 ， 我 还 喜欢 运行 四 种 类 型 的 自动 检查 工具 : 编码 标准 、 依 赖 性 分 析 、 代 码 履 盖 
范围 和 代码 复杂 度 。 我 不 是 将 这 些 测试 和 检查 工具 的 执行 放 在 一 个 庞大 的 构建 脚本 中 (还 加 
上 编译 、 数 据 库 集成 和 部 署 ) ， 而 是 将 测试 和 检查 工具 的 执行 目标 提取 到 两 个 不 同 的 构建 文 


件 中 ， 如 图 2 所 示 : 
PE 
local.properties 
E 


ES integration.properties | 
E Build script 
qa.properties 


production.properties 


更 小 、 更 简洁 的 构建 文件 维护 和 理解 起 来 要 容易 得 多 。 实 际 上 ， 这 种 模式 对 于 代码 而 言 同样 
适用 。 我 们 似乎 在 这 里 看 到 了 模式 的 概念 ， 不 是 吗 ? 


图 2. 提取 构建 文件 








没有 清理 


没有 严格 减少 所 有 底层 假设 的 构建 无 疑 是 一 颗 定 时 炸弹 。 例 如 ， 如 果 构 建 没有 避免 一 些 简 单 
的 假设 ， 例 如 会 去 掉 用 陈旧 的 数据 生成 的 二 进 制 文 件 ， 那 么 前 一 次 构建 遗留 下 来 的 文件 就 会 
引起 错误 。 或 者 ， 正 是 由 于 前 一 次 构建 留 下 的 文件 ， 构 建 竞 然 得 以 "成 功 "， 这 种 情况 更 糟糕 。 
幸运 的 是 ， 这 个 问题 的 解决 办 法 很 直观 : 只 需 删 除 任何 之 前 的 构建 留 下 的 所 有 目录 和 文件 ， 
就 可 以 很 容易 地 消除 假设 。 这 个 简单 的 动作 就 可 以 减少 假设 ， 保 证 构建 的 成 功 或 失败 都 是 正 
确 的 。 清 单 5 演示 了 通过 使 用 delete Ant 任务 删除 之 前 的 构建 所 使 用 的 所 有 文件 或 目录 ， 
从 而 清理 构建 环境 的 一 个 例子 : 


清单 5. 事先 清理 


«target name-z"clean"» 
«delete dir-z"$[logs.dirj" quiet-z"true" failonerrorz"false"/» 
«delete dir-"$[build.dirj" quiet-"true" failonerror-"false"/» 
«delete dir-"$[reports.dirj" quiet-"true" failonerror-"false"/» 
«delete file-z"cobertura.ser" quiet-"true" failonerror-"false"/» 
«/target» 


众所周知 ， 旧 的 构建 遗留 下 来 的 文件 会 导致 很 多 不 必要 的 麻烦 。 为 了 自己 的 方便 ， 在 运行 一 
个 构建 之 前 ， 务 必 先 删除 构建 所 创建 的 任何 工件 。 


硬 编码 的 自 味 


复制 -粘贴 式 的 编程 有 碍 重用 ， 将 值 进行 硬 编 码 又 何尝 不 是 呢 。 当 构建 脚本 包含 硬 编码 的 值 
时 ， 如 果 某 个 方面 需要 修改 ， 那 么 就 需要 在 多 个 地 方 修改 那个 值 。 更 糟糕 的 是 ， 很 可 能 会 急 
略 了 某 个 地 方 而 没有 改 那个 值 ， 从 而 引起 与 不 匹配 的 值 相 关 的 错误 ， 这 种 错误 是 很 隐蔽 的 。 
而 有 全 ， 如 果 相 信 我 的 建议 ， 选 择 使 用 多 个 构建 脚本 ， 那 么 硬 编码 的 值 将 可 能 会 成 为 构建 维护 
中 最 终 的 挑战 。 在 这 一 点 上 也 请 相信 我 ! 


例如 ， 在 清单 6 中 ， run-simian 任务 有 很 多 硬 编码 的 路 径 和 值 ， 即 reports 目录 : 


清单 6. 硬 编码 的 值 


<target name="run-simian"> 
«taskdef resourcez'"simiantask.properties" 
classpath-"simian.classpath" classpathref-"simian.classpath" /» 
«delete dirz"./ reports" quiet-"'"true" /> 
«mkdir dir-"./ reports" /> 
«simian thresholdz"2" language="java" 
ignoreCurlyBraces-"true" ignoreIdentifierCase-"true" ignoreStrings-"true" 
ignoreStringCase-"true" ignoreNumbers-z"true"  ignoreCharacters-'true'"» 
«fileset dir="${src.dir}"/> 
«formatter typez'"xml" toFile-z"./ reports/simian-log.xml" /> 
«/simian» 
«xslt taskname-"simian" 
inz"./ reports/simian-log.xml" 
out-z"./ reports/Simian-Report.html" 
style-"./ config/simian.xsl" /> 
</target> 


如 果 硬 编码 reports A R>’ MA ARAZA Simian kzal X —- E E. o» ARN o 
而 有 全 ， 如 果 其 他 工具 在 脚本 的 其 他 地 方 使 用 这 个 目录 ， 那 么 很 可 能 会 有 人 输 错 目录 名 称 ， 寻 
致 报告 显示 在 不 同 的 目录 中 。 这 时 可 以 定义 一 个 属性 值 ， 由 这 个 属性 值 指向 这 个 目录 。 然 

后 ， 在 整个 脚本 中 都 可 以 引用 这 个 属性 ， 这 意味 着 当 需 要 更 改 的 时 候 ， 只 需 光 顾 一 个 地 方 ， 
即 属性 的 定义 。 清 单 7 展示 了 重 构 之 后 的 run-simian 任务 : 


清单 7. 使 用 属性 


«target name-z"run-simian'"» 
«taskdef resourcez'"simiantask.properties" 
classpath-"simian.classpath" classpathref-"simian.classpath" /> 
«delete dirz'"$[reports.simian.dirj" quiet-"true" /> 
«mkdir dir-"$í[reports.simian.dir)" /> 
«simian threshold-"$[simian.threshold)" language-"$[language.typej" 
ignoreCurlyBraces-"true" ignoreIdentifierCase-"true" ignoreStrings-"true" 
ignoreStringCase-"true" ignoreNumbers-z"true"  ignoreCharacters-'true"» 
«fileset dir="${src.dir}"/> 
«formatter typez"xml" toFile-'"$í[reports.simian.dirj/$[simian.log.filej" /> 
«/simian» 
«xslt taskname-"simian" 
in-"$([reports.simian.dirj)/$([simian.log.file)" 
out-"$(reports.simian.dir)/$[simian.report.file]" 
style-"$([config.dirj/$([simian.xsl.file)" /> 
</target> 


硬 编码 的 值 不 仅 没 有 提高 灵活 性 ， 反 而 拟 制 了 灵活 性 。 就 像 在 源 代码 中 很 容易 硬 编 码 数据 库 
连接 string 一 样 ， 在 构建 脚本 中 也 应 该 避免 将 路 径 之 类 的 东西 硬 编码 。 


测试 失败 时 ， 构 建 却 能 成 功 


构建 远 远 不 止 于 单纯 的 源 代码 编译 ， 它 还 可 能 包括 自动 化 开发 者 测试 的 执行 ， 如 果 想 让 软件 
一 直 正 常 运 行 ， 那 么 决 不 能 允许 构建 中 有 任何 失败 的 测试 。 别 忘 了 ， 如 果 测 试 都 得 不 到 信 
任 ， 那 么 还 要 测试 干什么 呢 ? 


清单 8 是 这 种 构建 气味 的 一 个 例子 。 注 意 junit Ant 任务 的 haltonfailure 属性 被 设置 为 
false ( 它 的 缺 省 值 ) 。 这 意味 着 即使 任何 JUnit 测试 是 失败 的 ， 构 建 也 不 会 失败 。 


清单 8. 气味 : 测试 失败 ， 构 建 却 成 功 


«junit forkz"yes" haltonfailurez"false" dir="${basedir}" printsummaryz"yes"'» 
«classpath refid-"test.class.path" /> 
«classpath refid-'"project.class.path"/» 
«formatter type-z"plain" usefile-z"true" /> 
«formatter typez"xml" usefile-'true" /> 
«batchtest forkz"yes" todir="${logs.junit.dir}"> 
«fileset dir-"$[test.unit.dirj"» 

«patternset refid-z"test.sources.pattern"/» 

«/fileset» 
«/batchtest» 

«/junit» 


有 两 种 方法 防止 构建 中 的 这 种 气味 d 第 一 种 方法 是 将 haltonfailure 属性 设置 为 true 。 这 
样 就 可 以 防止 测试 失败 构建 却 成 功 的 情况 发 生 。 


对 于 这 种 方法 ， 我 惟一 不 喜欢 的 地 方 是 ， 我 想 看 看 有 多 大 百分比 的 测试 唱 到 了 失败 ， 以 便 弄 
清楚 失败 的 模式 。 因 此 第 二 种 方法 就 是 ， 每 当 有 测试 失败 ， 就 设置 一 个 属性 。 然 后 ， 我 对 Ant 
进行 配置 ， 使 得 当 执行 了 所 有 的 测试 之 后 ， 构 建 最 终 失 败 。 这 两 种 方法 都 行 之 有 效 。 清 单 9 
演示 了 使 用 tests.failed 属性 的 第 二 种 方法 : 


清单 9. 测试 令 构建 失败 


«junit dir-"$[basedirj" haltonfailure-"false" printsummary-"yes" 
errorProperty-"tests.failed" failureproperty-"tests.failed"- 
«classpath» 

«pathelement location-"$[classes.dir)" /> 
«/classpath» 
«batchtest fork-"yes" todir-"$(logs.junit.dirj" unless-"testcase"» 
«fileset dir-"$Í[src.dirj"» 
«include name-z"**/*Test*.java" /> 
«/fileset» 
«/batchtest» 
«formatter type-"plain" usefile-"true" /> 
«formatter typez"xml" usefile-'true" /> 
«/junit» 
«fail if-'"tests.failed" message-"Test(s) failed." /> 


如 果 测 试 失败 时 构建 还 能 通过 ， 就 会 提供 关于 安全 性 的 一 种 错 感 。 如 果 测 试 失败 ， 那 么 让 构 
建 也 失败 : 旱 一 点 从 容 地 处 理 问题 ， 总 比 以 后 问题 半夜 三 更 把 您 从 梦 中 唤醒 要 好 。 


魔力 机 的 气味 


在 本 文 谈 到 的 所 有 气味 当中 ， 这 一 种 也 许 是 最 难 闻 的 ， 因 为 魔力 机 (magic machine) 是 那 种 
刚好 惟一 能 够 构建 一 个 公司 的 软件 应 用 程序 的 硬件 。 这 种 情况 看 上 去 难以 相信 ， 实 则 不 然 。 
在 我 的 职业 生涯 中 ， 就 多 次 碰 到 过 它 。 当 依赖 性 丢失 ， 或 者 当 不 断 累 积 的 问题 爆发 时 ， 这 些 
机 器 就 获得 了 所 谓 的 魔力 。 

我 们 很 容易 看 出 ， 公 司 基 础 设施 中 的 一 台 正 常 的 机 器 是 如 何 获得 魔力 的 : 随 着 时 间 的 推移 ， 
开发 者 无 意 间 在 机 器 的 脚本 中 添加 了 硬性 的 依赖 性 ， 包 含 了 对 目录 路 径 的 全 限定 引用 ， 甚 至 
安装 了 只 有 一 台 机 器 上 有 的 工具 ， 久 而 久之 ， 构 建 在 任何 其 他 机 器 上 再 也 不 能 运行 了 。 图 3 
就 展示 了 一 个 例子 : 


图 3. 魔力 机 
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对 一 台 机 器 的 硬 编码 引用 ， 包 括 特 定 驱动 器 (例如 C : ) 的 路 径 ， 以 及 机 器 上 特有 的 工具 ， 
都 是 令 一 台 机 器 着 魔 的 罪魁 祸首 。 每 当 看 到 对 C: 盘 的 引用 ， 或 者 看 到 对 特定 工具 (例如 

grep ) 的 调用 时 ， 应 该 马上 更 改 脚本 。 如 果 发 现 自己 声称 " c:\program Files\ 目录 在 每 台 
机 器 上 都 有 " 的 时 候 ， 也 要 三 思 。 


不 良 格式 也 有 气味 


和 主流 语言 中 的 编程 格式 一 样 ， 在 管理 构建 脚本 的 时 候 ， 也 有 类 似 的 考虑。 当 为 构建 脚本 考 
虑 编程 格式 的 时 候 ， 需 要 考虑 以 下 几 个 方面 : 


e 属性 名 称 

e 目标 名 称 

e 目录 名 称 

e 环境 变量 名 称 
e 缩 进 

e 代码 行 长 度 


就 个 人 而 言 ， 对 于 格式 上 的 约定 ， 我 喜欢 尽 可 能 利用 他 人 的 规则 。 幸 运 的 是 ， 有 人 已 经 提供 
了 那样 的 参考 ， 即 The Elements of Ant Style ( 见 参考 资料 ) 。 在 这 本 书 中 ， 作 者 描述 了 各 
种 规则 ， 例 如 用 小 写字 母 如 上 用 于 分 隔 单词 的 连 字符 来 命名 目标 ， 以 及 代码 行 长 度 和 缩 进 
等 。 不 管 选择 哪 一 种 方法 ， 始 终 如 一 地 应 用 有 关 格 式 的 规则 有 助 于 构建 文件 的 长 期 维护 。 


构建 从 来 没有 如 此 好 间 


我 尚 能 忍受 廉价 香水 的 气味 。 但 是 ， 如 果 说 有 一 样 东西 我 无 法 忍受 的 话 ， 那 一 定 是 难于 维护 
的 构建 脚本 所 散发 出 的 气味 。 差 劲 的 代码 显然 会 浪费 您 宝贵 的 时 间 ， 设 计 不 良 的 构建 也 不 例 
外 。 如 果 构 建 中 还 球 散 着 不 一 致 的 、 不 可 重复 的 和 不 可 维护 的 气味 ， 那 么 现在 就 花 时 间 重 构 
这 些 至 关 重 要 的 资源 吧 。 您 的 开发 环境 定 会 香 如 玫瑰 。 


让 开发 自动 化 : 选择 持续 集成 服务 器 
对 开源 C1 服务 器 : CruiseControl ` Luntbuild 和 Continuum 的 调查 


由 于 有 许多 持续 集成 服务 (C1) 服务 器 可 以 选择 ， 所 以 很 难 决定 哪个 适应 自己 。 在 让 开发 自 
动 化 系列 的 第 二 篇 文章 中 ， 开 发 自动 化 专家 Duvall 采用 一 致 的 评估 标准 和 很 多 说 明 性 示例 ， 
介绍 了 一 些 开 源 Cl 服务 器 ， 包 括 Continuum ` CruiseControl 和 Luntbuild ° 


在 我 脑海 里 ， 我 至 少 能 想到 12 种 在 当前 市 场 上 可 用 的 Cl 服务器， 包括 商业 的 和 开源 的 。 虽 
然 它们 都 试图 自动 进行 软件 构建 的 过 程 ， 但 是 都 有 各 自 的 优点 和 不 足 。 而 且 ， 有 太 多 工具 可 
供 选 择 的 不 良 后 果 就 是 很 难 决定 究竟 应 该 选择 使 用 哪个 。 

在 选用 自动 化 过 程 的 工具 时 ， 要 时 刻 记 住 的 就 是 : 工具 要 确实 适用 。 选 择 错误 的 工具 可 能 会 


限制 整体 的 灵活 性 ， 会 导致 执行 简单 动作 反而 需要 更 长 时 间 ， 或 者 会 把 人 锁定 在 特定 的 支持 
工具 或 过 程 。 


选择 C1 服务 器 的 标准 
通常 ， 对 一 个 新 工具 的 决策 分 析 可 以 归结 如 下 : 


我 听 说 Tim 在 使 用 Acme Inc 的 工具 ， 而 且 我 认为 Tim 是 个 聪明 人 。 所 以 ， 我 也 要 使 用 
Acme Inc 的 工具 。 现 在 我 也 是 个 聪明 人 了 。 


关于 本 系列 


作为 开发 人 员 ， 我 们 的 工作 就 是 为 用 户 提 供 自动 化 处 理 ; 但 是 ， 我 们 中 的 许多 人 却 忽 视 了 自 
动 化 自己 的 开发 过 程 的 机 会 。 出 于 这 个 目的 ， 让 开发 自动 化 这 一 系列 的 文章 专门 研究 了 自动 
化 软件 开发 过 程 的 实际 应 用 ， 并 教 您 什么 时 候 和 如 何 成 功 应 用 自动 化 。 


反 过 来 ， 如 果 您 问 Tim 为 什么 他 选择 使 用 Acme Inc 的 工具 ， 您 可 能 会 发 现 是 他 的 公司 强制 

要 求 使 用 的 。 这 就 是 为 什么 重要 的 是 要 根据 自己 的 具体 技术 和 政策 需求 对 工具 进行 分 析 。 如 
果 不 这 么 做 ， 可 能 就 会 选择 到 不 符合 需求 的 工具 ， 共 至 更 糟糕 的 是 ， 不 能 带 来 任何 帮助 的 工 

fa 


在 决策 的 时 候 ， 通 常 多 数 人 都 会 把 重点 放 在 工具 的 特性 上 。 但 是 要 记 住 ， 虽 然 特性 的 确 重 
要 ， 但 还 有 其 他 指标 需要 考虑 。 在 我 的 实践 中 ， 我 发 现 以 下 五 个 指标 在 评估 工具 时 最 有 帮 
B) : 


什么 是 持续 集成 ? 


持续 集成 (CI) 是 一 种 实践 ， 可 以 让 团队 在 持续 的 基础 上 收 到 反馈 并 进行 改进 ， 不 必 等 到 开 
发 周期 后 期 才 寻 找 和 修复 缺陷 。 诸 如 CruiseControl 之 类 i NAM NA 运行 的 ， 它 们 轮 
询 版 本 控制 存储 库 ， 从 中 寻找 更 改 之 处 。 当 发 现 某 一 更 改 时 ， 这 类 工具 就 会 通过 Ant 执行 预 
定义 的 构建 脚本 。 持 续 检查 借助 持续 集成 的 实践 得 以 改进 


。 特性 

e 可 靠 性 

e 寿命 

e 目标 环境 
e 易 用 性 


而 且 不 要 忘记 ， 客 观 地 检查 这 五 个 方面 也 是 重要 的 。 


产品 特性 


说 到 Cl 服务 器 的 特性 ， 应 当 考 虑 该 工具 与 版 本 控制 系统 的 集成 、 处 理 构建 平台 (例如 Ant 和 
Maven) 的 能 力 以 及 提供 反馈 和 报告 的 能 力 。 而 且 不 要 忘记 检查 其 他 特性 ， 例 如 构建 标号 和 
管理 项 目的 依赖 项 。 最 后 ， 在 需要 做 一 些 特定 的 增强 时 ， 理 解 产 品 的 可 扩展 性 会 很 有 帮助 。 


表 1 详细 说 明了 每 个 特性 


表 1. 详细 的 C1 服务 器 评估 特性 
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在 选择 CI 服务 器 时 ， 需 要 考虑 目前 或 将 要 使 用 哪个 构建 工具 。 对 于 Java™ 编 
程 ， 有 两 个 自然 的 选择 : Ant 和 Maven， 几 乎 所 有 CI 工具 都 支持 它们 。 如 果 构 建 
系统 既 不 是 Ant 也 不 是 Maven， 那 么 CI 工具 支持 从 命令 行 运行 程序 的 功能 么 ? 


想 想 老话 “如 果树 倒 在 森林 中 ， 能 有 人 听 到 么 ? "如果 构建 失败 ， 会 有 人 知道 么 ? 
Mu de > 那么 使 用 CI 工具 的 目的 是 什么 ?所 有 的 CI 工具 都 提供 一 些 通知 
机 制 ， 但 是 哪个 最 适合 您 呢 ? 电子 邮件 ? 即时 消息 ?RSS ? 


有 些 开发 团队 总 欢 跟踪 构建 ， 给 构建 一 个 唯一 的 标号 ， 这 样 日 后 就 能 找到 具体 的 
构建 实例 。 如 果 这 对 您 来 说 很 重要 ， 那 么 要 注意 只 有 少数 C1 服务 器 提供 了 这 个 功 


26 
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某 些 情况 下 ， 在 构建 了 一 个 项 目 之 后 ， 可 能 需要 构建 其 他 依赖 项 目 。 有 些 CI 服务 
器 支持 这 个 特性 ， 有 些 不 支持 。 


扩展 工具 当前 的 功能 有 多 容易 ?3 是否 用 插件 就 可 以 实现 简单 的 扩展 ， 还 是 总 得 修 
改 代码 ? 


从 特性 的 角度 来 说 ， 以 上 提 到 的 几 点 在 选择 所 需要 的 正确 的 CI 服务 器 时 ， 至 关 重 要 。 


产品 可 靠 性 


因为 下 载 和 使 用 开源 Cl 服务 器 很 简单 ， 所 以 可 以 试用 产品 来 判断 它 的 可 靠 性 。 而 且 ， 在 工具 
的 可 靠 性 和 它 在 市 场 上 的 时 间 之 间 ， 通 常 存在 一 些 相 关 性 。 使 用 新 产品 时 ， 就 会 冒 着 有 未 发 
现 的 bug 的 风险 。 而 且 ， 用 户 群 是 发 现 工 具 出 现 的 问题 的 优秀 资源 。 大 量 的 问题 贴 子 或 者 过 
多 的 复杂 问题 ， 就 表示 用 户 对 这 个 工具 的 意见 较 大 。 


因为 我 这 里 讨论 的 服务 器 是 开源 的 ， ap la 这 也 会 是 产品 健康 程度 的 
一 个 指示 。 用 户 少 可 能 意味 着 反馈 渠道 少 ， 可 能 需要 换个 地 方 看 看 。 


寿命 前 景 


在 下 载 C1 服务 器 之 前 ， 了 解 这 个 服务 器 未 来 的 前 景 会 有 帮助 。 简 单 地 说 ， 使 用 已 经 死亡 或 正 
走向 死亡 的 产品 不 是 个 好 主意 。 可 以 检查 该 工具 已 经 出 现 了 多 少年 、 在 它 的 用 户 群 中 是 否 有 
正常 数量 的 活动 。 就 像 可 以 从 用 户 群 来 判断 产品 的 可 靠 性 一 样 ， 活 跃 的 社区 是 工具 未 来 前 景 
良好 的 征兆 。 


目标 环境 


CI 服务 器 不 能 在 所 有 环境 下 工作 。 需 要 考虑 服务 器 支持 哪个 操作 系统 以 及 具体 的 系统 需求 。 
例如 ， 如 果 工 具 是 用 最 新 版 本 的 Python 编写 的 ， 那 么 需要 确定 这 个 版 本 Python 能 够 用 于 自 
己 的 操作 系统 。 


易 用 性 


产品 的 易 用 性 可 外 EE 是 最 主观 的 指标 。 有 些 人 愿 意 手工 修改 配置 文件 ， 而 有 些 人 想 让 所 有 管理 
任务 都 在 应 用 程序 中 执行 ， 例 如 Web 控制 台 。 有 些 服 务 器 要 求 从 一 个 屏幕 单 击 到 下 一 个 屏幕 
来 执行 简单 的 管理 ， 而 其 他 服务 器 则 提供 了 直观 的 向 导 。 


如 果 想 理解 C| 服务 器 的 具体 细节 ， 那 么 漂亮 的 管理 Web 表单 就 不 重要 了 ; 但 是 ， 如 果 人 手 
不 足 、 工 作 繁忙 ， 那 么 可 能 不 会 想 在 管理 CI 服务 器 上 花 太 多 时 间 。 


记 住 我 在 这 节 讨 论 的 五 个 方面 ， 再 来 看 一 下 三 个 C1 服务 器 : Apache 的 Continuum ` 
CruiseControl 和 构建 管理 服务 器 Luntbuild ° 


Apache Continuum 


Continuum 是 最 新 的 C1 服务 器 之 一 ， 也 是 值得 关注 的 一 个 新 进入 者 。Continuum 的 安装 和 配 
2 : 只 要 下 载 和 释放 ZIP 文件 ， 运 行 命令 行程 序 ， 就 可 以 运行 了 。 基 于 Web 的 界面 使 
得 配置 项 目 很 容易 。 而 有 全 ， 还 不 需要 安装 Web 服务 器 ， 因 为 Continuum 内 置 了 Jetty Web 
o E > Continuum 可 以 作为 Windows 服务 运行 ， 还 在 应 用 程序 的 某 些 部 分 嵌入 了 上 

下 文敏 感 的 文档 ， 从 而 提供 了 很 多 帮助 。 


想 要 更 多 细节 信息 ? 


面 对 如 此 之 多 CI 服务 器 可 以 选择 ， 本 文 可 以 引导 您 更 详细 地 研究 每 个 服务 器 ， 并 决定 哪个 最 

适 。 因 为 我 比较 了 三 个 不 同 的 服务 器 ， 所 以 我 没有 深入 每 个 服务 器 的 特定 细节 。 我 只 是 把 
& 点 放 在 了 这 些 服 务 器 安装 后 就 提供 的 选项 上 。 如 果 需 要 更 多 信息 ， 请 参考 每 个 服务 器 的 安 
装 和 配置 指南 。 


易于 使 用 


在 使 用 Continuum 时 会 注意 到 的 第 一 件 事 就 是 它 的 易 用 性 。 能 够 在 几 分 钟 之 内 就 把 服务 器 运 
行 起 来 并 让 它 去 查询 修改 。 实 际 上 ， 在 Windows 上 启用 Continuum 只 需要 四 步 


下 载 Continuum ZIP 文件 (请 参阅 参考 资料 ) 。 
把 文件 的 内 容 释 放 到 本 地 目录 。 

运行 run.bat 文件 ， 然 后 运行 InstallService.bat 。 
打开 浏览 器 指向 http://localhost:8080/。 


AOUN‘ 


Continuum 内 置 支持 五 个 版 本 控制 系统 : Subversion ` CVS ` StarTeam ` Bazaar 和 
Perforce 。 也 部 分 地 支持 其 他 版 本 控制 工具 ， 例 如 Visual Source Safe 和 ClearCase ° 
Continuum 还 支持 四 种 构建 机 制 : Ant、Maven1、Maven2 和 Shell (命令 行 ) 。 


配置 Continuum 


在 第 一 次 访问 Continuum Web 应 用 程序 时 ， 默 认 是 guest 帐户 。guest 提供 了 对 所 有 项 目的 
只 读 存 取 ， 没 有 管理 或 配置 项 目的 能 力 。 但 是 ， 可 以 很 容易 地 创建 Administrative 用 户 ， 然 后 
设置 一 些 适 用 于 所 有 项 目的 属性 。 


图 1 显示 了 管理 页 面 ， 它 提供 了 管理 所 有 项 目的 Continuum 设置 的 能 力 ， 包 括 创建 Admin 帐 
户 、 构 建 的 输出 和 部 署 目 录 : 


图 1. Continuum 的 配置 很 简单 


? Configure Continuum - Mozilla Firefox 





fle gi yew (Go Bokeek lods bep deljou 
一 一 [Your company logo here]. ^ 


continuum 
b 


Admin account 


Username 
Password 

Re-enter Password 
Full Name 

Email 


Directories 
Working Directory ~vorking-Srectory 
If you define a relative path, it will be relative to C: Vdevtoolsycontinuum- 1.0.3 binhwin 32. ^. apps continuum 
Build Output buid-output directory 
Directory if you define à relative path, it will be relative to C: VdevAtoolsycontinuum- 1.0. 3 binwin 32^, ^. Nappsvcontinuum 
Deployment 


Repository Directory Optional. tf you define a relative path, it wil be relative to 
C:NdevAtoolsNcontinuum- 1.0. 3NbimNwin32^. ^. Nappsycontiuum 


Base URL 
Base URL httei/Iccalhort:8000/contbinuum/rerviet/ continu 
Company Informations 


Name 


Logo 


O re [7] Match case 


Pto: farven apache. ezgkortnuumy ndi zd o x 


把 项 目 添加 到 监视 器 


对 Continuum 3 MUN nin 监视 项 目 也 非常 简单 。 简 单 到 仅仅 是 选择 期 望 的 构建 平台 ， 例 如 
Ant 或 Maven2， 然 后 把 Continuum 指 到 期 望 的 版 本 控制 系统 。 


图 2 显示 了 设置 Ant 项 目 时 需要 填充 的 字段 : 


图 2. 在 Continuum 中 创建 项 目 





J Add Ant Project - Mozilla Firefox 


fle gk Yew do looks Loos b dojdou 
— [Your company logo here]. ^ 
continuum 
b 
| Welcome, Paul Owwali - Discsanat 0000000000000 Contin [ Maven | Apache 


Continuum Add Ant Project 
z Project Name  »mteentor 
Enter the project name 
Version 1.0 
Enter the verson of the project 
Sem Uri scmisveihttpi//www-quahtylabs.ceg/ sen/ ambienkcet/trunk 
Enter the Maven SOM URL 
Scm Username rank 
Enter the scm username 
Scm Password "ett 
Enter the scm password 
Scm Branch/Taq 


Legend Enter the scm branch/tag name ( For subversion, tag name must be in som URL and not in 


tabin DD this field ) 
-— 3 
Buld In Progess 2 
hecking Ost beidd — 
~ 
O re C] Match case. 


ore i mn ox 
i 


在 保存 了 这 个 信息 之 后 ，Continuum 每 小 时 查询 版 本 控制 系统 一 次 。 可 以 修改 项 目的 设置 ， 
查询 得 更 频繁 或 更 少 些 。 我 们 在 这 里 谈 到 的 是 持续 集成 ， 我 建议 每 五 分 钟 检查 修改 一 次 ， 而 
不 要 每 小 时 一 次 。 


默认 情况 下 ， 在 使 用 Ant 时 ，Continuum 在 项 目的 根 目录 查找 项 目的 build.xml 文件 。 如 果 使 
用 不 同 的 名 称 或 者 这 个 文件 不 在 项 目的 根 目录 ， 可 以 修改 这 个 设置 。 


虽然 Continuum 还 是 CI 舞台 上 的 新 人 ， 但 是 它 以 其 易 用 性 和 对 当前 众多 流行 的 版 本 控制 系 
统 和 构建 工具 的 支持 ， 还 是 给 这 一 领域 带 来 了 巨大 的 冲击 。 我 希望 在 未 来 的 版 本 中 会 有 添加 
和 查看 报告 的 功能 。 


CruiseControl 


CruiseControl 是 CI 服务 器 的 老者 。 它 已 经 用 了 有 五 年 多 了 ， 在 许多 方面 ，CruiseControl Ak 
务 器 已 经 成 为 持续 集成 实践 的 同义词 。 出 于 完全 坦白 的 目的 ， 我 应 当 提 到 ， 我 也 是 
CruiseControl 的 多 年 的 老 用 户 。 


进 的 安装 


如 果 您 从 最 后 一 次 使 用 CruiseControl 到 现在 已 经 有 段 时 间 ， 而 且 认 为 它 的 安装 和 配置 是 个 负 
担 ， 那 么 您 可 以 看 看 最 新 版 本 。 现 有 ， 有 许多 方式 安装 CruiseControl。 例 如 ， 如 果 使 用 
Windows， 会 发 现 最 简单 的 方式 是 下 载 二 进 制 可 执行 文件 ， 然 后 运行 它 。 不 用 担心 ， 还 可 以 
下 载 源 代码 。 


安装 之 后 ，CruiseControl 预先 配置 了 一 个 配置 文件 ， 轮 询 CVS 存储 库 并 执行 Ant 构建 脚 
本 。 同 样 也 不 需要 安装 Web 服务 器 ， 因 为 CruiseControl %4 A 3X f Jetty。 


轮 询 版 本 控制 系统 


比 起 Luntbuild 和 Continuum ， EE Md 提供 了 对 超过 十 种 不 同 版 本 控制 系统 的 支持 。 
m E > CruiseControl 对 这 些 工 具 中 的 许多 定制 命令 也 提供 了 支持 。 清 单 1 是 一 个 使 用 
CruiseControl config.xml 脚本 轮 询 Subversion 示例 : 


清单 1. 通过 config.xml 文件 轮 询 存 储 库 


«listeners» 
«currentbuildstatuslistener file-"logs/$[project.namej)/status.txt"/» 
«/listeners» 
«modificationset quietperiod-"30"- 
«svn RepositoryLocationz"http://www.qualitylabs.org/svn/ambientorb/trunk" 
username-"bfranklin" 
password-"GOFlyQKite" 
/? 
«/modificationset» 


执行 构建 脚本 


当 在 版 本 控制 系统 (例如 Subversion) 中 发 现 修 改 时 ， 可 以 很 容易 地 配置 CruiseControl 去 
执行 委托 的 构建 脚本 。 例 如 ， 清 单 2 演示 了 从 config.xml 调用 Ant 脚本 ， 它 指示 
CruiseControl 每 60 秒 钟 查询 Subversion 存储 库 一 次 ， 并 执行 另 一 个 Ant 脚本 。 委托 的 构 
建 脚本 (没有 显示 ) 删除 昌文 件 ， 从 Subversion 签 出 最 新 的 源 代码 ， 并 在 代码 上 运行 项 目的 
构建 脚本 。 


清单 2. 执行 Ant 构建 脚本 


«schedule interval-"60"» 
«ant anthome-"apache-ant-1.6.5" buildfile-'"build-$([project.namej.xml"/» 
«/schedule» 


当 设置 了 CruiseControl 的 这 个 方面 并 启动 服务 器 之 后 ， 可 以 访问 如 图 3 所 示 的 
CruiseControl Web 控制 板 : 


图 3. CruiseControl 控制 板 
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BUILD COMPLETE - build.2 
Project Date of build: 08/13/2006 132250 
Time to build: 40 seconds 
Last changed: 08/10/2006 16 3305 
Last loq entry: 
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C'devitocis cruisecontrol- 2 5 Oipeogects vnbientortinará rc Vor get yt nbientorblantVAgributeMapper ja 引 Line contains a tab Character 
C wiev'tocis orusecontrok- 2 5 Oprow ts vwnibwentornttrunh enc vor eal iab vtbvent orb wet e tributeMapper ja 33 Line Corti a teb Character 
C'dev'tocisterusecontrok- 2 5 Opeogects wnbsentorti trunks tor at ynet tt AeributeMapper jo 35 Line contains a tab Character 
C wlev'boois oruisecontrok- 2 5 Ogrowcts nbsentortitrurnh anc vor gpadt vias vncbeentorb et V tributeMapper ja I Line contin a tab character 
C'vlevitocis oruisecontrol- 2 5 Oprogects nbientortitnuná ancor guias embientorblnt VAEributeMapper joa 39 Line contams a tab Character 
C vev'tocit orusecontrok- 2 5 (irosects nbwentorttrarnà erc vor gua iab tbeertorbntUAtribuleMapper va 41 Line cortan a tab Character 
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C Vlev'tocis erasecontroi- 2 5 Ügeogcts nbventort/trurà arc vor g'aualit iab wrbentorbwnt VA tribuleMapper jr 45 Line coreans a tab character 
C Wevtoots erusecontrol- 2 5 Ügroyects wnbientort/tnunk arc or gi mt tne umberto bian ributeMapper jaa 47 Line contains a fab character 

weveoots crusecontrol- 2 5 (iprocts wmbientort trunk arc or ge mt iab wrenrtor tt VributeMapper jm 49 Line cortans a fab character 
C Viev'tootsierusecontrol- 2 5 Oproiects wnbentorti/trurk erc or guia wrbientorblwntAgributeMapper ja $1 Line corti a tab character 
C wev'toois erasecontrol- 2 5 (Üiproects wnbientort/trurnk arc or ge mt yia wmbientorbwnt VtributeMapper ja 5) Line conta a tab character 
C Vlev'tocis oruisecontrol- 2 5 Oprowcts umberto birunk erc vor gusti wrnbientorbwnt VAfributeMapper ja 55 Line corti a tab character 
C Vev'tocis iorumsecontrol 2 5 (iprosects umberto t nun arc or guit vios wmbientorbwnt VtributeMapper ja 57 Line contis a fab character 
C vievitociscnasecontrol- 2 5 Ügroyect s wnbientort/tnuriierc or gast yis vnbientorbvwnf AEributeMapper je 59 Line coreans a tab character 
C weveools onasecontrok. 2 5 Oprosects wnibientontonanà erc vor gioi abs wmbient orb wet Arte Mapper ja 61 Line cortwns a tab Character 
C'vievitociricnasecontrol- 2 5 Ogrorects wnbientortitnurkterc or gt yt vmbientorbwnt AgributeMapper jio 63 Line cortiwns a tab character 
C wlev'tooisicnusecontrok- 2 5 Opeosects wnbientorttnuré erc or gusittiaibs wnbientoro wt AtributeMapper wa 65 Line cortwns a tab Character 
Cvev'tocisoruisecontroi- 2 5 Opeoyect s wnbientorti/tnuráóarc or gt yt wnbientorbwntVAEributeMapger je 67 Line cortsins a tab character 
C wev'toois crusecontrol- 2 5 Oprosects wwnibventortnanà erc vor goat abs wmbientorb wet Arue Mapper «o 9 Line coreans a tab Charscter 
C'vlevitocis oruisecontroi- 2 5 Üpeoyects wnbientort/bnurk erc vor o qualitas wnbientorb'wntVAEributeMapper java 71 Line contains a tab character 
C wetoois crusecontro- 2 5 Opeosects veibventontrurnà erc vor guai ias nt to bat AmributeMapper jia 73 Line cortan a tab Character 
C'idev'toois eruisecontrol- 2 5 Oproects vnbentorttruni arc tor g'ausiit labs embientorblantVAgributeMapper ja 75 Line cortas a eb character 
C wie v'tooit icrursecontroi- 2 5 Opeoects mibentorttrunà enc vor guayaba ert to bat AmributeMapper ima 77 Line cortas a tab Character 
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CruiseControl 控制 板 


要 接收 最 新 构建 的 反馈 ， 可 以 把 htmlemail 插件 添加 到 清单 3 所 示 的 config.xml 脚本 。 可 以 
用 config.xml 文件 配置 更 多 反馈 机 制 ， 例 如 发 送 文本 消息 、 电 子 设备 (通过 X10) 、 甚 至 即 
时 消息 。 


清单 3. 用 CruiseControl 发 送 电子 邮件 


«plugin name-"htmlemail" 
buildresultsurl-z"http://$[env.COMPUTERNAME)/cruisecontrol/buildresults/$[project.namej" 
mailhost-"$[smtp.serverj" 
username-"$[mail.usernamej" 
password-"$(mail.passwordj" 
returnaddressz'$[buildmaster.emailj" 
returnname-"$([buildmaster.namej" 
subjectprefix-"$(project.namej build" 
xsldir-"webapps/cruisecontrol/xsl" 
css-"$(reportdirj/cruisecontrol.css"/» 


«htmlemail» 
«always address-"$[buildmaster.email)"/-» 
«failure address-"$[buildmaster.emailj"/-» 
«/htmlemail» 


E — g 


CruiseControl 提供 了 许多 有 用 的 特性 ， 有 强大 的 用 户 社区 ， 极 具 扩 展 性 。 与 本 文中 评估 的 其 
他 工具 相 比 ， 有些 开 发 人 员 觉 得 CruiseControl 不 太 容 易 使 用 。 而 另 一 方面 ， 有 些 开 发 人 员 则 
发 现 用 XML 脚本 进行 修改 提供 了 更 好 的 控制 。 


Luntbuild 


从 面市 年 头 上 说 ，Luntbuild 位 于 Continuum 和 CruiseControl 之 间 。 上 比 起 Continuum 和 
CruiseControl，Luntbuild 的 目标 是 为 并 行 开发 和 用 户 管理 之 类 的 事情 提供 支持 的 构建 管理 服 
务 器 。 它 的 整个 配置 是 通过 Web 应 用 程序 管理 的 ， 所 以 没有 配置 文件 需要 处 理 。 它 也 有 商业 
版 可 以 使 用 ， 叫 作 QuickBuild， 商 业 版 中 包含 用 户 支 持 。 


Jetty 不 再 必需 


Luntbuild 提供 了 几 种 安装 方式 。 您 可 能 会 发 现 最 简单 的 方式 是 通过 GUI 安装 。 用 Web 应 用 
程序 配置 和 管理 Luntbuild ; 所 以 ， 需 要 确保 正在 运行 一 个 能 够 处 理 JSP 的 Web 服务 器 ， 像 
Tomcat 或 Jetty ° 


版 本 控制 轮 询 


Luntbuild 提供 了 对 入 种 不 同 版 本 控制 系统 的 支持 ， 例 如 CVS ` Subversion ` ClearCase 和 
Perforce ° A 4 演示 了 Luntbuild 被 设置 成 轮 询 Subversion : 


图 4. Luntbuild 轮 询 Subversion 存储 库 
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nake your software an ble - Mozilla Firefox 
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Editing VCS information (Fields marked with the * are required) 


@ Version ComtrolSystem [Subversion v 


Select the type of the Version Control System. 





EJ Repository url base hip jwww qualityiabs. org/svr/ambieetoebirunk | 
The base part of Subversion url, for example, you can input "svn//buddmachme foobar com/", or "Be lie /sv reposttory", or 
*sen/buddmachme foobar coem/myproject/othersubdzectory", etc. Other de&nitions such as tags directory, branches directory, of 
modules are relative to this base url. NOTE If you are using bp3 schema, you should make sure that svn server cert&cate has 























been accepted permermantly by your build machine. 

B Directory for trunk V | 
Dzectory used to hold trunk for thus url base. This directory is relative to the url base. Leave 2 blank, £ you didn't defne any trunk. 
directory m the above url base 

E] Directory for branches [ ] 
Drectory used to hold branches for tias url base. This directory is relative to the url base. I£ jeft blank, "branches" will be used as 
the defwat value 

E Directory for tags Hem i 
Dzectory used to hold tags for thus url base. This drectory is relative to the url base. If left blank, "tags" wil be used as the definit 
value 

LJ) Usemaene bronkin ] 
User name to use to logn to Subversion. 

E Password E-— ] 


Password to use to logn to Subversion. 








执行 构建 


Luntbuild 支持 五 种 不 同 的 构建 平台 ， 和 包括 Ant、Maven、Maven2、 命 令 行 和 rake (用 来 构 
建 Ruby 应 用 程序 ) 。 图 5 显示 了 Ant 构建 器 的 配置 页 面 


图 5. 用 Luntbuild 执行 Ant 脚本 


nake your software 
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Editing builder information (Fields marked with the * are required) 
A, bulder type [Amwbuidee = 
t n type of bulder 
iy Name em 
Provide a name to identify this bulder, thes name can be changed later. 
E] Command to run Art 1 Vdev tools apsche-ant-1. 6, 5Nbinlant,bat 





Specify the command to run Ant (normally path to ant bat or aet shell script) here. For example /patb/to/ant 
-DbualdVersonz"$ (buld version)" -DartifactsDa-"$ (budd art£actsDir) Sting enclosed by $(..) will be interpreted as OGNL. 
expresion, and it be evaluated before execution. For vabd OGNL expressions m this context, please refer to the User's Guide. 
NOTE. A tingje argument that inciodes rpacet should be quoted m order not to be interpreted as emulple arguments 

加 Budd script path fouéd eml ]* 
The path for the Ant buld scnpt. I£ thus path is not an absolute path, it is assumed that it is relative to the schedule work directory. 
Refer to the User's Guide for detads about how to wnte a new Ant buld fle or how to modiy your existing Ant bušd script 


E Budd targets bud. ] 
Specify the targets to buld Use space to separate different targets (target name contammg spaces should be quoted in order not to| a 
[NN RENTUR TT Ef & 
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构建 安排 


通过 使 用 Luntbuild 中 的 Schedule 标签 (如 图 6 所 示 ) ， 可 以 设置 Luntbuild 多 久 轮 询 一 次 


版 本 控制 系统 来 获得 修改 。 在 这 个 标签 上 ， 还 可 以 指定 分 配给 每 个 构建 的 唯一 构建 标号 。 


图 6. 在 Luntbuild 中 安排 构建 
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Creating a new schedule (Fields marked with the * are required) 











dy Name Continuous a 
Prode a name for thes schedule 


B Description Check for changes every five minutes] 


Prode a description for thas schedule 


Mj Next buld version luntbuild-$4écurmeniDey system {years "-" month «*-* «deyOtMonth). flastDayproject var da^] sefValue(t * 
Nen bald version for thes schedde. The version werements as fobows 
luntbuild- 1.9 wil be mcreased to kantbudd- 1 10 
luztbuid- 1.5 (budd 1000) wil be mereased to hatbudd- 1 5 (budd 1001) 
You can also insert variables(enclosed by $(...) ) to the version string to make it more flexible. For example, the version stnng can | 
be defined as 
lurfbuid-$ (ScurrertDayesystem (year*" -" *monthre" -edayOfMonth), SlastDayeproject var[* day") setValue(ScurrentDay), 
WdayIteratorzproject var[" dayIterator"] mtV alue, 
project var[" dayIzerator"] setintValue(ScurrentDay—lastDay?idayIterator* 1:1), ScurreszDay) $ (project var(" dayIterator"]) 
Then the actual version strag for a budd wil inchade the bald date and gerasons For that date. Or you can specify the version 
stnng as 
luztbudd- ] 0 $ (project var["verssonIterator"] increase AsInt()) 
In this way, last digt of the vermon wil take the increased value of a project variable named by "versonIterator* | 
For details, please refer to the Uter's Gude 









在 Luntbuild 中 发 布 结果 


配置 了 项 目 、 版 本 控制 系统 适配器 、 构 建 和 计划 程序 之 后 ， 就 可 以 指定 用 户 接收 反馈 的 方式 
了 。 但 是 ，Luntbuild 只 内 置 了 对 电子 邮件 和 即时 消息 的 支持 。 另 外 ， 可 以 从 Luntbuild 的 主 


页 监视 构建 ， 如 图 7 PUR: 


图 7. 从 Luntbuild Web 应 用 程序 监视 构建 
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Luntbuild 提供 了 一 整套 强大 的 功能 ， 包 括 管 理 项 目 依赖 项 和 大 量 的 版 本 控制 系统 适配器 。 我 
认为 工作 流 和 用 户 界 面 可 以 简化 ， 因 为 需要 许多 步骤 来 设置 和 配置 工具 。 


Cl 记分 卡 


在 不 理解 具体 需求 的 情况 下 ， 就 推荐 哪个 工具 合适 
的 特性 ， 而 且 就 像 我 在 开始 时 所 提 到 的 ， 仅 仅 因 为 
必然 满足 您 的 需求 。 


是 非常 冒失 的 。 每 个 服务 器 都 有 许多 优秀 
某 个 CI1 服务 器 最 适合 某 人 ， 并 不 意味 着 它 


如 果 寻 找 的 是 多 于 使 用 的 工具 ， 请 选择 Continuum 。 如 果 扩 展 性 、 灵 活性 和 繁荣 的 用 户 社区 
对 您 很 重要 ， 请 使 用 CruiseControl。 如 果 需 要 Web 管理 和 扩展 的 用 户 支 持 选项 ， 请 考虑 
Luntbuild。 围 绕 这 些 服 务 器 已 经 形成 了 开发 “生态 "系统 ， 所 以 如 果 遗 漏 了 某 个 特性 ， 一 般 都 会 
找到 适合 需求 的 扩展 。 


在 表 2 中 ， 是 我 根据 自己 的 使 用 经 验 为 所 考察 的 每 个 Cl 服务 器 总 结 的 特性 、 可 人 千 性、 寿命 、 
目标 环境 和 易 用 性 这 五 个 核心 方面 : 


表 2. CI 服务 器 五 个 核心 方面 


, TE Æ BRM JA 
iis 性 命 境 性 


支持 Ant、Maven1 和 Maven? > A 


Continuum 及 shell > 
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使 用 XML-RPC 和 SOAP 的 远程 管理 能 力 ; 支持 Maven2 ; 用 户 群 ; 期 待 未 来 有 附加 的 报告 
和 反馈 机 制 多 改 代 码 。 | Æ 2005 年 发 布 。 期 待 通过 它 与 Apache 的 关系 ， 得 到 
Cn a Apache Maven 的 良好 用 户 社 区 支持 产品 在 市 场 上 仍 很 新 。 | 
Linux ` Mac OS X ` Solaris 和 Win32 » | 优秀 的 易 用 性 和 安装 。|| CruiseControl | 许多 版 
本 控制 集成 和 扩展 性 。 通 过 JMX 控制 的 远程 访问 。 多 种 反馈 机 制 ， 包 括 RSS、X10、Jabber 
以 及 其 他 。 | 在 2001 年 发 布 。 在 三 个 服务 器 中 ，CruiseControl 在 开发 中 应 用 得 最 多 。 | 繁荣 
的 用 户 社区 ; 每 个 迹象 都 表示 CruiseControl 还 会 存在 一 段 时 间 。 | Windows 和 Unix ; 任何 
能 运行 Java JVM 的 平台 。 | 多 于 安装 。 有 些 人 宁愿 不 修改 XML 配置 文件 。 | | Luntbuild | 
项 目 依赖 项 、 标 号 、 安 全 性 组 和 并 行 开 发 。| 在 2004 年 发 布 。Luntbuild 提供 扩展 的 用 户 支 持 
选项 。| 用 户 社区 不 如 CruiseControl 活跃 。| 能 够 运行 JVM 和 servlet 容器 的 系统 。| 易于 
安装 ， 但 用 户 界面 /工作 流 需要 大 大 改进 。 基 于 Web 的 配置 〈 不 需要 修改 配置 文件 ) 。 | 





我 在 本 文中 只 评估 了 三 个 服务 器 ; 还 有 许多 服务 器 可 能 LU PE p Mee 
如 何 挑选 C| 服务 器 ， 那 么 选择 工作 就 应 当 很 容易 了 。 请 继续 关注 下 个 月 的 文章 ， 我 将 介绍 在 
开发 项 目 中 经 常会 遇 到 的 构建 问题 。 


让 开发 自动 化 : 持续 检查 


把 自己 从 软件 检查 员 寻 常 的 手工 检查 工作 中 解放 出 来 


在 开始 新 项 目 时 ， 多 数 人 计划 在 将 代码 投入 生产 发 行 之 前 审核 它们 ; 但 是 ， 当 提交 日 程 超越 
了 其 他 因素 时 ， 审 核 常常 成 为 第 一 个 被 抛弃 的 实践 。 如 果 能 够 自动 执行 其 中 一 些 审核 ， 那 么 
情况 又 会 怎样 呢 ? 在 新 系列 “让 开发 自动 化 ”的 第 一 篇 文章 中 ， 开 发 自动 化 专家 Paul Duvall 首 
先 将 研究 如 何 自 动 化 检查 器 (例如 CheckStyle、JavaNCSS 和 CPD) 、 如 何 改进 开发 过 程 ， 
以 及 应 该 什么 时 候 使 用 它们 。 


代码 检查 可 以 采用 不 同 的 形式 。 有 些 企业 使 用 正式 的 同 级 评审 (peer review) ， 在 该 评审 过 
程 中 ， 开 发 人 员 要 为 代码 提供 同 级 评价 ， 并 提供 改进 意见 ; 其 他 一 些 企业 使 用 结对 编程 ; 还 
有 一 些 人 则 考虑 使 用 高 级 设计 决策 和 推荐 的 代码 改进 。 有 些 团队 会 在 将 代码 提交 到 版 本 控制 
存储 库 之 前 ， 让 其 他 开发 人 员 用 “桌面 检查 ” 的 形式 审查 他 们 的 代码 。 


不 论 企业 采用 哪 种 方式 进行 代码 检查 ， 有 一 件 事 是 肯定 的 : 它们 几乎 都 是 手工 过 程 。 正 如 我 
多 年 所 观察 到 的 ， x ms 易 出 错 ， 如 果 工 作 紧 张 ， 就 会 忘记 自己 正在 做 什么 。 但 是 ， 
软件 检查 不 必 总 是 手工 完成 ; 实际 上 ， 有 一 大 堆 开 源 工具 和 商业 工具 (我 称 之 为 软件 检查 
R) ， 可 以 用 它们 很 方便 地 对 代码 进行 静态 分 析 (这 些 工具 也 称 为 静态 分 析 工 具 ) 。 


使 用 软件 检查 器 ， 代 码 检 查 可 以 通过 Ant 或 Maven 这 样 的 构建 工具 来 自动 完成 。 通 过 使 用 这 
种 自动 化 ， 一 些 低级 的 源 代码 细节 (如 编码 标准 、 复 杂 性 和 重复 程度 等 ) 的 处 理 成 为 了 机 器 
的 职责 。 这 种 职责 转移 通过 将 重点 转向 更 高 级 的 开发 方面 (比如 设计 和 长 期 维护 问题 ) 提高 
了 人 们 手工 检查 的 效率 。 


关于 本 系列 


作为 开发 人 员 ， 我 们 的 工作 就 是 为 用 户 提供 自动 化 处 理 ; 但 是 ， 我 们 中 的 许多 人 却 忽视 了 自 
动 化 自己 的 开发 过 程 的 机 会 。 出 于 这 个 目的 ， 让 开发 自动 化 这 一 系列 的 文章 专门 研究 了 自动 
化 软件 开发 过 程 的 实际 应 用 ， 并 教 您 什么 时 候 和 如 何 成 功 地 应 用 自动 化 。 


用 软件 检查 器 来 解决 问题 


软件 检查 器 有 很 多 ， 范 围 从 复杂 的 商业 工具 到 简单 的 开源 替代 工具 。 但 是 ， 我 发 现 其 中 三 
特别 有 用 ， 它 们 是 CheckStyle、CPD 和 JavaNCSS (请 参阅 参考 资料 ) 


。 CheckStyle 报告 与 项 目 预 定 的 编码 标准 的 偏离 度 。 
e CPD 报告 代码 重复 。 
e JavaNCSS 可 以 帮助 团队 专注 于 更 高 级 的 代码 复杂 性 领域 。 


所 有 这 些 工具 都 可 以 免费 得 到 ， 而 且 易 于 集成 到 Ant 或 Maven 这 样 的 构建 平台 中 ， 因 此 它们 
AZ xS Es) 系统 中 。 


什么 是 持续 集成 ? 


持续 集成 (CI) 是 一 种 实践 ， 可 以 让 团队 在 持续 的 基础 上 收 到 反馈 并 进行 改进 ， 不 必 等 到 开 
发 周期 后 期 才 寻 找 和 修复 缺陷 。 诸 如 CruiseControl 之 类 aa 后 BS 的 ， 它 们 轮 
询 版 本 控制 存储 库 ， 从 中 寻找 更 改 之 处 。 当 发 现 某 一 更 改 时 ， 这 类 工具 就 会 通过 Ant 执行 预 
定义 的 构建 脚本 。 持 续 检查 借助 持续 集成 的 实践 得 以 改进 


检查 器 样式 标准 


我 参与 了 几 家 公司 的 委员 会 ， 花 了 很 多 时 间 来 定义 编码 标准 。 有 一 次 ， 我 们 定义 了 几乎 没 人 
遵守 的 25 页 的 编码 标准 文档 。 结 果 ， 我 们 的 代码 审查 非常 痛苦 ， 因 为 团队 要 花 时 间 来 挑 错 ， 
看 看 开发 人 员 是 否 使 用 了 两 个 空格 规则 (与 四 个 空格 规则 相对 ) ， 以 及 是 否 将 参数 声明 为 
final 。 如 果 把 这 些 低级 检查 工作 交 给 软件 检查 器 ， 我 们 会 节省 许多 宝贵 的 时 间 。 


使 用 自动 的 源 代码 检查 工具 (如 CheckStyle) 可 以 提供 执行 可 配置 规则 集 的 简单 途径 ， 规 则 
集 可 以 根据 项 目的 编码 标准 而 定 。 此 外 ， 可 以 通过 CheckStyle 插件 在 IDE 中 运行 
CheckStyle > CheckStyle 通过 它 的 Ant 任务 或 Maven 插件 直接 集成 到 构建 脚本 中 。 
CheckStyle 发 现 的 所 有 规则 偏离 都 会 以 报告 的 形式 显示 ， 清 楚 地 指出 哪 一 个 文件 违规 。 除 此 
之 外 ， 还 可 以 将 Ant 和 Maven 配置 成 与 CheckStyle 相 呼 应 ， 这 样 ， 在 违反 规则 时 ， 构 建 工 
作 就 会 失败 。 


例如 ， 清 单 1 演示 了 Ant 构建 脚本 的 一 个 代码 段 ， 它 运行 CheckStyle 生成 HTML 报告 。 请 
注意 failonviolation 属性 ， 在 这 里 它 被 设 为 false 。 如 果 将 该 属性 设 为 true ， 则 在 发 现 
任何 源 代码 违规 时 ， 构 建 都 会 失败 。 


清单 1. 将 CheckStyle 用 于 Ant 


«taskdef resourcez'checkstyletask.properties" classpath="${checkstyle.jar}"/> 
«checkstyle config-"$[basedir)/cs-rules.xml" failOnViolation-"false'» 
«formatter toFile-"$[checkstyle.data.file)" typez'"xml" /> 
«fileset casesensitive-'"yes" dir-"$[src.dir)" includesz'"**/*,java" /> 
«/checkstyle» 
«xslt taskname-'"checkstyle" 
in-"$([checkstyle.data.filej" 
out-"$([checkstyle.report.file]" 
style-'"$[checkstyle.xsl.filej" /> 


在 清单 1 中 ， config 被 设置 成 cs-rules.xml ， 这 表示 将 根据 源 代 码 目 录 (在 fileset dir 

属性 中 ) 以 递归 的 方式 运行 规则 文件 。 xslt 任务 接受 根据 formatter toFile 属性 生成 的 文 
件 。 该 任务 使 用 XSL 文件 checkstyle.xsl 将 清单 1 生成 的 XML 转换 成 一 个 可 读 的 HTML X 

件 ，XSL 文件 checkstyle.xsl 包含 在 CheckStyle 安装 文件 中 。 


清单 2 是 CheckStyle 规则 文件 的 示例 片段 。CheckStyle 可 以 在 代码 基 上 运行 120 多 个 规 
则 。 


清单 2. 在 cs-rules.xml 文件 中 定义 的 CheckStyle 规则 


<module name="Checker"> 
«module name="TreeWalker"> 
«property name="cacheFile" value="target/checkstyle.cache"/> 
«property name-"tabWidth" value="4"/> 
«module name-"ImportOrder"- 
«property name-"ordered" value-"true"/» 
«property name-"separated" value-"true"/» 
«/module» 
«module name="LineLength"> 
«property name-"max" value-z"120"/» 
«/module» 
«module name="FileLength"> 
«property name-"max" value="400"/> 
«/module» 
«module name-"UnusedImports"/» 
«/module» 
«/module» 


每 个 CheckStyle 规则 都 是 一 个 模块 。 例 如 ， LineLength 模块 建立 的 规则 是 : 所 有 行 中 的 字 
符 都 不 得 超过 120 个 字符 ， 否 则 CheckStyle 就 生成 错误 。 


可 以 用 定制 规则 扩展 CheckStyle， 所 以 也 可 以 容易 地 实施 编码 规则 。 而 且 ， 它 是 自动 执行 
的 | 


图 1 显示 了 使 用 Ant 生成 的 CheckStyle 报告 的 一 个 示例 ， 这 是 清单 1 中 所 演示 的 xslt 任 


务 : 


图 1. CheckStyle HTML 报告 


! CheckStyle Audit - Mozilla Firefox 





Ge E yew do (Qodmwis [ch ipo 





CheckStyle Audit r- 
Designed for use with CheckStyle and Ara 

File C^deviqualitylabsambientorb'archorgqualitylabs'ambientorb'anfOrbl istener java 

Error Description Line 
Naene "orb. query" must match patem "(3-2][a-2A-20-9]"$' 40 
Name ‘orb dewce' most match pattem *(a-z|[a-24-2D-9|"$ 41 
Name "orb. animabon fai musst match pattem *(a-z][a-2/20-9]*$ 42 
Name "orb. armmabon pass must match patem "[3-2]|a-2^- DSTs. 44 
Name ‘orb_color pass' most match pattem *(a-z|[|a-z^-ZD-9]*$ 46 
Name "orb. color faif must match pattem *[a-z [a zA«ZD-9|"$ 47 
Name 'orb comment pass" must match partem [2-2] à-2^-20-9 P$ 48 
Name 'orb commert fal’ must match pattem "(az ][|a«24.70-9]"$ 49 
Parameter orb. device should be fal 54 
Name "orb. device" most match pattem *(a-z][a-2^-2D-S]" $ 54 
Parameter orb animation fail should be final 54 
Naene "orb. armmabon, fad" must match pattem *(a-z][a-2A-ZD-9]"$ 54 
Parameter orb animation pass should be fnal 55 
Name 'orb animabon pass must match pattem *[a2-2][a 2470-9] $* 55 
Parameter orb color pass should be final 55 
Name "orb color pass' most match pattem *(a-z|[a-24-ZD-9]*$ £5 
Parameter orb. color fail should be final 55 
Nene vrb color faif must match patteen "[a-2 i zA-20-9|"$ 55 
Parameter orb comment pass should be final 56 
Name 'orb comment pass' must match pattem *[a-2 a-z^ maps 55 

w 


ore 


> 
; 
| 
| 


用 IDE 怎么 样 ? 


我 听 到 的 一 个 普遍 反应 是 这 些 检查 可 以 在 IDE 中 运行 。 尽 管 确实 如 此 ， 并 且 极 力 推荐 这 样 
做 ， 但 是 拥有 一 台 对 源 代码 运行 一 组 公用 规则 集 (使 用 Ant 这 样 的 工具 ) 的 单独 机 器 的 好 处 
是 : 一 致 性 更 好 。 


用 CPD 进行 重复 性 检查 


面向 对 象 编 程 的 一 个 主要 目的 是 通过 创建 可 以 适应 不 同上 下 文 的 可 重用 对 象 来 促进 重用 。 但 
是 ， 通 常 使 用 的 是 “复制 -粘贴 ” 编程 ， 并 将 它 伪 装 成 “重用 "。 有 时 ， 出 现 这 种 情况 是 因为 开发 

人 员 不 知道 有 可 重用 的 组 件 ， 而 其 他 时 候 ， 则 是 因为 提供 了 "快速 修复 ”。 所以， 如果 需要 进行 
修改 ， 则 必须 将 更 改 应 用 到 所 有 副本 和 变 体 中 (当然 ， 如 果 没 有 工具 很 难 完成 ) 。 这 种 手工 
方式 带 来 了 维护 困难 并 很 容易 导致 遗漏 ， 甚 至 会 带 来 缺陷 


CPD 是 流行 的 开源 静态 分 析 工 具 PMD 的 一 部 分 ， 它 报告 代码 基 中 重复 行 的 数量 。 此 外 ， 
CPD 的 标志 阅 值 是 可 配置 的 ， 这 意味 着 可 以 修改 CPD 建议 的 重复 行 数 。 例 如 ， 如 果 将 阅 值 
设置 成 100 个 标志 ，CPD 就 会 在 至 少 重复 了 100 个 标志 的 时 候 显 示 一 个 实例 。 不 过 请 记 
住 ， 源 代码 总 是 会 包含 一 些 重 复 部 分 ; CPD 只 是 为 团队 提供 了 一 种 调查 值得 考虑 的 代码 重复 
领域 的 手段 ， 在 这 个 领域 内 ， 可 以 采取 纠正 措施 ， 例 如 有 目的 的 重 构 。 


清单 3 演示 将 CPD 用 于 Ant 的 实际 使 用 。CPD 任务 需要 的 第 一 个 选项 是 
minimumTokencount 属性 ， 该 属性 用 于 指定 要 比较 的 标志 的 数量 (最 小 值 是 一 个 标志 ) 。 另 
外 ， 可 以 设置 CPD 忽略 某 些 代码 选项 ， 例 如 标识 符 和 标量 。 在 这 个 示例 中 ，Ant fileset X 


型 指定 了 CPD 文件 应 该 分 析 哪 些 文 件 ， 以 及 应 该 忽略 哪些 文件 。 
清单 3. 将 CPD 用 于 Ant 


«taskdef name="cpd" 
classname-"net.sourceforge.pmd.cpd.CPDTask" classpathrefz"pmd.classpath" /> 
«cpd minimumTokenCount-z'100" 

formatz"xml1l" 

language-"java" 

ignoreIdentifiers-"true" 

ignoreLiterals-"true" 

outputFile-"$([basedirj/cpd.xml"» 

«fileset dir-"$[src.dirj"» 
«include namez"**/*,java" /» 
«include namez"**/*,jsp" /> 
«include namez"**/*,xml" /> 
«exclude namez"**/*Test*.java" /> 

«/fileset» 

«/cpd» 


如 图 2 所 示 ，cpd.xml 是 用 清单 3 中 的 outputrile 属性 产生 的 输出 。 以 后 我 还 将 向 CPD 7 
加 XSL > RAR HTML 报告 。 


图 2. 显示 代码 重复 违规 的 CPD XML 输出 


除了 最 明显 的 复制 -粘贴 违规 之 外 ， 在 所 有 地 方 手 工 查 找 重复 代码 也 非常 具有 挑战 性 。 但 是 ， 
使 用 诸如 CPD 之 类 的 工具 ， 就 可 以 迅速 找 出 重复 代码 ， 然 后 对 此 进行 改进 。 


路 径 是 什么 ? 


源 代码 路 径 也 叫做 流程 控制 语句 ， 它 指示 在 方法 中 更 改 流程 的 代码 。 这 类 示例 包括 条 件 语句 
(de if 语句 ) ， 或 者 循环 构造 (如 while 和 for ) ° 


用 JavaNCSS 检查 复杂 性 


许多 研究 已 经 证 实 ， 随 着 方法 中 路 径 数 量 的 增加 ， 理 解 和 维护 同一 方法 的 难度 也 随 之 增加 。 
结果 ， 代 码 越 难 以 理解 和 维护 ， 就 越 容易 出 现 缺 陷 。 

JavaNCSS 是 一 个 免费 工具 ， 提 供 了 不 同 的 代码 测量 ， 例 如 非 注释 性 源 代码 语句 (或 代码 
fp) 的 数量 、 所 有 分 析 过 的 方法 的 圈 复 杂 度 量 值 (cyclomatic complexity number) 。 清 单 4 
演示 了 JavaNCSS 的 使 用 ， 可 以 看 到 ， 它 不 是 很 难 使 用 。 只 要 将 JavaNCSS 指向 一 个 包含 源 
代码 的 目录 ， 让 它 自己 处 理 就 行 了 ! 


清单 4. 将 JavaNCSS 用 于 Ant 


«path id-"javancss.classpath"» 
«fileset dir-"$(lib.dirj" /> 
«/path» 
«taskdef name-"javancss" classpathref-"javancss.classpath" 
classname-z"javancss.JavancssAntTask"» 
«/taskdef» 
«javancss srcdir-"$Í[src.dirj" 
generateReport-"true" 
outputfile-"$[javancss.report.dirj/javancss metrics.xml" 
formatz"xml1"/» 


像 多 数 软 件 检查 器 一 样 ， 这 里 生成 了 一 个 XML 文件 ， 可 以 通过 XSLT 很 容易 地 将 它 转换 成 一 
个 HTML 报告 ， 就 像 图 3 中 所 做 的 那样 : 


图 3. JavaNCSS HTML 报告 





JavaNCSS Analysis - Mozilla Firefox = [9 [X 
pe iR w LA indiana inm un» reeerm ee ee rrre ee were nm T 
Average Object NCSS: 6331 ^ 
Average Object Functions: 13.78 
Average Object Inner Classes: 0.33 
Average Object Javadoc Comments: 247 
Program NCSS: 636.00 
Functions 
1 1 org.qualtylabs ambientorb.ant.Fileuti Fileutl( ) 

2 9 org.qualtylabs .ambentorb.ant.FileUbl find WnkableDirOnClasspath() 
3 17 org.quaktylabs arbientorb.ant.F'ileUbl.geti ytesF'romF'le(f?e) 

4 1 org.qualtylabs amdientord ,ant.FileUbl,FileUuH) 

5 9 org.qualtylabs ambientorb. ant. Fileubl find wrkableDirOnClasspath() 
6 17 org.qualtylabs .ambientorb.ant.FieUbl.getB ytesFromFile( Fée) 

? è org.quaktylabs ambientorb.ant.FleUblTest FleUtiI Testi String) 

8 13 org.qualtylabs ambientorb.ant.FleUbITest testStnngTokenmzern) 

$ 6 org.quaktylabs ambientorb. ant.FileUbITest testfFindWritableDir( ) 

10 16 org.quaktylabs .ambientorb.ant.FileUbITest testGetB ytesFromFde() 
11 1 org.quaktylabs aembientorb.ant.FleUbITest. verify OnClasspath(File) 
12 org.quaktylabs ambientorb ant.OrbListener.OrbListener() 

13 org.qualtylabs acbientorb.ant.OrbListener.OrbListeeer( String, String, String String String, String, String) 
14 org.qualtylabs ambientorb.ant.OrbListener.buidStarted(BuldE vent) 


org.quaktylabs ambientorb.ant.OrbUstener buddFiwished(BuilsE vent) 
org.qualtylabs .ambientorb.ant.OrbListener.createUrti Stnng, String, String, String, String, Project) 
org.qualtylabs aembientorb.ant.OrbLishener targetStarted(BuldE vent) 
org.qualtylabs ambientorb ant.OrbListener targetFinished(BuidE vent) 
org.quaktylabs ambientorb ant. OrbListener task Started( BuilE vent) 
org.quaktylabs ambientorb.ant.OrbListener taskFireshed( baldEvent) 
org.qualtylabs armbientorb ant. OrbListener.messageLogged(BuddE vent) 
org.qualtylabs ambientorb.ant.OrbListener.getOrb. anmabon, fai) 
org.qualtylabs ambientorb.ant.OrbListeeer.setOrb. animation fad(String) 
org.quaktylabs .ambientorb.ant.OrbUstener.getOrb anematon pass) 
org.quaktylabs ambientorb.ant.OrbListener.setOrb, animation eass(String) 
org.quaktylabs ambientorb.ant.OrbListener.getOrb color, fad) 
org.qualtylabs ambientorb.ant.OrbLishener.setOrb. color fal String) 
org.quaktylabs .ambientorb.ant.OrbUstener.getOrb color passi) 
org.qualtylabs ambientorb.ant. OrbUistener.setOrb, color pass(Stnng) 
org.qualtylabs .ambientorb.ant.OrbListener.getOrb. device) 
org.qualtylabs ambientorb.ant.OrbListener.setOrb. device( String) 

org. Raise Ambientorb.ant.OrbUstener. GOR comment passi) 
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理解 应 用 程序 代码 复杂 性 可 没有 那么 容易 。 实 际 上 ， 在 菜 些 情况 下 ， 复 杂 性 的 值 可 能 会 令 人 
误解 。 例 如 ， 有 些 工具 为 switch 语句 提供 较 高 的 值 。 但 是 我 发 现 ， 使 用 JavaNCSS 这 样 的 
工具 ， 有 助 于 降低 高 复杂 性 的 领域 ， 最终 提 高 代码 的 可 理解 性 和 可 维护 性 。 


对 每 个 更 改 都 进行 检查 ， 将 缺陷 控制 在 限度 内 
每 当 团 队 成 员 向 版 本 控制 存储 库 提交 更 改 时 ， 代 码 就 会 发 生 改 变 。 但 它 是 怎么 改变 的 呢 ? 被 


修改 的 代码 是 受到 复制 -粘贴 工作 的 影响 吗 ? 复杂 性 会 增加 吗 ? 了 解 这 些 的 0 pe 
次 签 入 时 都 运行 软件 检查 器 。 此 外 ， 在 持续 的 基础 上 接受 目前 为 止 讨论 过 的 每 种 风险 的 反 
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馈 ， 这 是 一 种 自动 让 代码 基 进 行 健康 检查 的 一 种 可 靠 方 式 | 


Cruise 与 CI 


CruiseControl 是 Java™ 社区 使 用 最 广 的 开源 CI 工具 之 一 。 这 个 工具 被 配置 成 在 后 台 运 行 ， 
用 于 检索 版 本 控制 存储 库 ， 例 如 CVS。 在 发 现 源 代码 更 改 时 (例如 ， 有 人 签 入 了 代码 ) ， 
CruiseControl 就 会 执行 源 代码 签 出 ， 并 运行 预定 义 的 构建 脚本 。 


所 以 ， 只 要 版 本 控 种 oo 变化 ， 团 队 就 可 以 运行 Cheol CPD 和 

JavaNCSS 这 样 的 软件 检查 器 能 力 允 许 团 队长 时 间 地 进行 监视 和 执行 检查 ， 通 过 使 用 

iiid CI 工具 ， E E. Mer pe Ambient Orb 这 样 的 设备 生成 报告 ( 参 
见 图 5) œ 


清单 5 演示 了 使 用 CruiseControl 的 配置 文件 (通常 名 为 config.xml) 在 CruiseControl 控制 
板 上 显示 CheckStyle 报告 的 结果 。 其 他 软件 检查 器 使 用 类 似 的 语法 将 结果 合并 到 
CruiseControl 仪表 板 中 。 


清单 5. 在 config.xml 中 用 CruiseControl 记录 CheckStyle 


«listeners» 
«currentbuildstatuslistener file-"logs/$[project.name)/status.txt"/» 
«/listeners» 
«modificationset quietperiod-"30"- 
«svn RepositoryLocationz"http://www.qualitylabs.org/svn/ambientorb" 
username-z"[username]" 
passwordz" [password]" 
/? 
«/modificationset» 
«schedule interval-"60"» 
«ant anthome-"apache-ant-1.6.5" buildfile-"build-$[project.namej).xml"/» 
«/schedule» 
«log» 
«merge dir-"merge dir-"checkout/$[project.name)/ reports/checkstyle" /> 
«/log» 


图 4 显示 了 用 CruiseControl 和 CheckStyle 生成 的 示例 报告 。 请 注意 ， 可 以 配置 
CruiseControl， 显 示 其 他 工具 ( 像 CPD 和 JavaNCSS) 的 报告 ， 而 且 通 过 对 每 个 源 代 码 更 
改 都 运行 这 些 报告 ， 团 队 可 以 实时 地 积极 改进 代码 ， 不 必 等 到 周期 末期 。 


图 4. 与 CruiseControl 集成 的 CheckStyle 报告 
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Ambient 反馈 


对 于 使 用 CI 工具 持续 运行 软件 检查 器 而 言 ， 最 酷 的 事 就 是 团队 有 了 无 数 任意 使 用 的 通知 机 
制 。 有 时 ， 构 建 可 能 并 没有 失败 ， 但 是 有 些 事 的 变化 要 求 早 些 而 不 是 晚 些 采取 纠正 行动 。 例 
如 ， 实 际 上 可 以 很 容易 地 配置 一 个 设备 〈 就 像 Ambient Orb) ， 在 代码 复杂 度 有 所 上 升 时 ， 或 
者 在 违反 一 定数 量 的 代码 标准 时 ， 使 用 该 设备 改变 颜色 。 


清单 6 使 用 了 Ambient Orb Ant 任务 和 Ruby 脚本 ， 在 20 个 以 上 的 类 超过 300 个 源 代 码 行 
(SLOC) 时 ， 就 改变 Orb 的 颜色 和 动画 。 在 这 个 示例 中 ， 我 选择 在 类 满足 条 件 时 将 orb 的 
颜色 改 成 magenta ， 将 动画 改 成 crescendo ° 


清单 6. 委托 Ant 构建 文件 处 理 CruiseControl 和 Ambient Orb 


«target name-"checkSloc" » 
«exec dir-"$[basedir)" executable-"cmd.exe"- 
«arg line-"/c $[config.dirj/javancss/SlocThreshold.rb 
$[reports.javancss.dirj/javancss metrics.xml 20 $[javancss.filej"/» 
«/exec» 
«available file-"$[basedirj/$[javancss.file)" property-z"sloc.exceeded"/» 
«antcall target-"notifyOrb" /> 
</target> 


«target name-"notifyOrb" if="sloc.exceeded"> 
«taskdef classname-"org.qualitylabs.ambientorb.ant.OrbTask" 
name-"orb" classpathref-'"orb.class.path"/» 
«orb queryz"http://myambient.com:8080/java/my devices/submitdata.jsp" 
deviceId-"AAA-9A9-AA9" 
colorPass-"green" 
colorFail-"magenta" 
animationPass-"none" 
animationFail-"crescendo" 
commentFail-"SLOC*Exceeded" /> 
«/target» 


图 5. Ambient Orb 





使 用 这 种 Ambient Orb 通知 方法 ， 就 不 会 收 到 无 穷尽 的 电子 邮件 ， 只 要 看 一 眼 SLOC 
Threshold Orb， 就 可 以 快速 了 解 我 有 多 少 个 大 型 类 ， 它 们 提醒 我 要 重 定向 重 构 工作 。 当 然 ， 
组 合 ambient orb 与 软件 监视 器 〈 稍 带 些 创意 ) 也 会 创造 无 穷 的 可 能 性 ! 


在 合适 的 时 候 自 动 化 


请 记 住 ， 可 以 选择 许多 不 同 的 软件 检查 器 。 虽 然 这 里 分 析 了 三 个 我 喜欢 的 软件 检查 器 ， 但 我 
还 是 被 JDepend ` PMD 和 FindBugs 工具 (后 两 个 检查 器 在 developerWorks 上 已 详细 讨论 
过 ) 所 打动 。 一 旦 开始 持续 检查 过 程 ， 插 入 一 个 新 的 检查 器 只 是 几 分 钟 的 事 而 已 。 


持续 检查 不 会 也 不 应 该 消除 手工 软件 检查 ; 但 是 ， 通 过 对 版 本 控制 存储 库 中 的 每 个 更 改 都 运 
行 一 套 自动 检查 工具 ， 将 要 执行 的 这 些 手工 检查 会 带 来 更 高 的 生产 率 和 效率 。 而 且 ， 持 续 检 
查 带 来 的 额外 好 处 有 : 风险 在 每 一 步 上 都 可 以 降低 ， 而 不 必 等 到 项 目 后 期 。 


下 一 个 月 ， 我 将 深入 研究 一 些 更 有 趣 的 持续 集成 工具 ， 例 如 CruiseControl ` Luntbuild 和 
Continuum ， 并 让 您 确定 哪 一 个 工具 最 适合 您 。 自 动 化 从 未 这 么 有 趣 过 ! 
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